CO_AF_TAPI_INCOMING_CALL_PARAMETERS structure
Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
The CO_AF_TAPI_INCOMING_CALL_PARAMETERS structure specifies the TAPI call parameters for an incoming call.
Syntax
typedef struct _CO_AF_TAPI_INCOMING_CALL_PARAMETERS {
ULONG ulLineID;
ULONG ulAddressID;
ULONG ulFlags;
NDIS_VAR_DATA_DESC LineCallInfo;
} CO_AF_TAPI_INCOMING_CALL_PARAMETERS, *PCO_AF_TAPI_INCOMING_CALL_PARAMETERS;
Members
ulLineID
Specifies a zero-based line identifier. The call manager or MCM driver must set this value to the value of the corresponding ulLineID in the LINE_CALL_INFO structure.ulAddressID
Specifies a zero-based address identifier on the line specified by ulLineID. The call manager or MCM driver must set this value to the value of the corresponding ulAddressID in the LINE_CALL_INFO structure.ulFlags
The call manager or MCM driver must set the CO_TAPI_FLAG_INCOMING_CALL bit in ulFlags. All other bits are reserved and must be set to 0.LineCallInfo
Specifies an NDIS_VAR_DATA_DESC structure that contains an offset from the beginning of the NDIS_VAR_DATA_DESC structure to a LINE_CALL_INFO structure. The NDIS_VAR_DATA_DESC structure also specifies the length of the LINE_CALL_INFO structure. The LINE_CALL_INFO structure specifies the TAPI call parameters for an incoming call. For more information about the LINE_CALL_INFO structure, see the Microsoft Windows SDK and the ndistapi.h header file.
Remarks
A call manager or integrated MCM driver that supports the CO_ADDRESS_FAMILY_TAPI_PROXY address family specifies the TAPI parameters of an incoming connection-oriented call in a CO_AF_TAPI_INCOMING_CALL_PARAMETERS structure. The call manager or MCM driver overlays this structure on CO_CALL_PARAMETERS. MediaParameters-> MediaSpecific.Parameters[] and sets the Length member of the CO_SPECIFIC_PARAMETERS structure that describes the media-specific parameters to the total length of the Parameters[] array. The call manager or MCM driver passes the encapsulated CO_AF_TAPI_INCOMING_CALL_PARAMETERS structure to NdisCmActivateVc or NdisMCmActivateVc when activating a VC for an incoming call and to NdisCmDispatchIncomingCall or NdisMCmDispatchIncomingCall when indicating the incoming call to a client.
The connection-oriented client to which the incoming call is dispatched (that is, the client that receives the CO_CALL_PARAMETERS structure in its ProtocolClIncomingCall function) should examine only the CO_AF_TAPI_INCOMING_CALL_PARAMETERS structure contained in CO_CALL_PARAMETERS. MediaParameters-> MediaSpecific. Parameters[]. No other call parameters are meaningful in this case.
Requirements
Header |
Ndistapi.h (include Ndis.h) |
See also