|
LINE_CALLINFO
The LINE_CALLINFO message is sent when the call information about the
specified call has changed. The application can invoke lineGetCallInfo to determine the current call information.
LINE_CALLINFO
dwDevice = (DWORD) hCall;
dwCallbackInstance = (DWORD) hCallback;
dwParam1 = (DWORD) CallInfoState;
dwParam2 = (DWORD) 0;
dwParam3 = (DWORD) 0;
Parameters
dwDevice
A handle to the call.
dwCallbackInstance
The callback instance supplied when opening the call's line.
dwParam1
The call information item that has changed. Can be a combination of these
values:
LINECALLINFOSTATE_OTHER
Information items other than those listed below have changed. The application
should check the current call information to determine which items have
changed.
LINECALLINFOSTATE_DEVSPECIFIC
The device-specific field of the call-information record has changed.
LINECALLINFOSTATE_BEARERMODE
The bearer mode field of the call-information record has changed.
LINECALLINFOSTATE_RATE
The rate field of the call-information record has changed.
LINECALLINFOSTATE_MEDIAMODE
The media mode field of the call-information record has changed.
LINECALLINFOSTATE_APPSPECIFIC
The application-specific field of the call-information record has changed.
LINECALLINFOSTATE_CALLID
The call ID field of the call-information record has changed.
LINECALLINFOSTATE_RELATEDCALLID
The related call ID field of the call-information record has changed.
LINECALLINFOSTATE_ORIGIN
The origin field of the call-information record has changed.
LINECALLINFOSTATE_REASON
The reason field of the call-information record has changed.
LINECALLINFOSTATE_COMPLETIONID
The completion ID field of the call-information record has changed.
LINECALLINFOSTATE_NUMOWNERINCR
The number of owner fields in the call-information record was increased.
LINECALLINFOSTATE_NUMOWNERDECR
The number of owner fields in the call-information record was decreased.
LINECALLINFOSTATE_NUMMONITORS
The number of monitors fields in the call-information record has changed.
LINECALLINFOSTATE_TRUNK
The trunk field of the call information record has changed.
LINECALLINFOSTATE_CALLERID
One of the callerID-related fields of the call information record has changed.
LINECALLINFOSTATE_CALLEDID
One of the calledID-related fields of the call information record has changed.
LINECALLINFOSTATE_CONNECTEDID
One of the connectedID-related fields of the call information record has
changed.
LINECALLINFOSTATE_REDIRECTIONID
One of the redirectionID-related fields of the call information record has
changed.
LINECALLINFOSTATE_REDIRECTINGID
One of the redirectingID-related fields of the call information record has
changed.
LINECALLINFOSTATE_DISPLAY
The display field of the call information record has changed.
LINECALLINFOSTATE_USERUSERINFO
The user-to-user information of the call information record has changed.
LINECALLINFOSTATE_HIGHLEVELCOMP
The high-level compatibility field of the call information record has changed.
LINECALLINFOSTATE_LOWLEVELCOMP
The low-level compatibility field of the call information record has changed.
LINECALLINFOSTATE_CHARGINGINFO
The charging information of the call information record has changed.
LINECALLINFOSTATE_TERMINAL
The terminal mode information of the call information record has changed.
LINECALLINFOSTATE_DIALPARAMS
The dial parameters of the call information record has changed.
LINECALLINFOSTATE_MONITORMODES
One or more of the digit, tone, or media monitoring fields in the call
information record has changed.
dwParam2
Unused.
dwParam3
Unused.
Return Values
No return value.
Remarks
A LINE_CALLINFO message with a NumOwnersIncr, NumOwnersDecr, and/or NumMonitorsChanged indication is sent to applications that already have a handle for the call.
This can be the result of another application changing ownership or monitorship
to a call with lineOpen, lineClose, lineShutdown, lineSetCallPrivilege, lineGetNewCalls, and lineGetConfRelatedCalls.
These LINE_CALLINFO messages are not sent when a notification of a new call is
provided in a LINE_CALLSTATE message, because the call information already reflects the correct number of
owners and monitors at the time the LINE_CALLSTATE messages are sent.
LINE_CALLINFO messages are also suppressed in the case where a call is offered by TAPI
to monitors through the LINECALLSTATE_UNKNOWN mechanism.
Note The application which causes a change in the number of owners or monitors
(for example, by invoking lineDeallocateCall or lineSetCallPrivilege) will not itself receive a message indicating that the change has been done.
No LINE_CALLINFO messages are sent for a call after the call has entered the idle state. Specifically, changes in the number of owners and monitors are not
reported as applications deallocate their handles for the idle call.
See Also
lineClose, lineDeallocateCall, lineGetCallInfo, lineGetConfRelatedCalls, lineGetNewCalls, lineOpen, lineSetCallPrivilege, lineShutdown
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Unix Manual Pages
|
