LINE_CALLINFO  1VU6_R5

The LINE_CALLINFO message is sent when the call information about the specified call has changed. The application can invoke lineGetCallInfo1UPWZV0 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 lineOpen85WLQP, lineClose4OH836K, lineShutdown3BUZZJU, lineSetCallPrivilege1OKJQIA, lineGetNewCalls1DTOAWP, and lineGetConfRelatedCalls57._OY.

These LINE_CALLINFO messages are not sent when a notification of a new call is provided in a LINE_CALLSTATEL6OAC. 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