CO_AF_TAPI_SAP 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_SAP structure specifies TAPI service access point (SAP) information.

Syntax

typedef struct _CO_AF_TAPI_SAP {
  ULONG ulLineID;
  ULONG ulAddressID;
  ULONG ulMediaModes;
} CO_AF_TAPI_SAP, *PCO_AF_TAPI_SAP;

Members

  • ulLineID
    Specifies a zero-based line identifier. If the call manager or MCM driver does not support per-line capabilities, the client sets ulLineID to CO_TAPI_LINE_ID_UNSPECIFIED.

  • ulAddressID
    Specifies a zero-based address identifier on the line specified by ulLineID. If the call manager or MCM driver does not support per-address capabilities, the client sets ulAddressID to CO_TAPI_ADDRESS_ID_UNSPECIFIED.

  • ulMediaModes
    Specifies the media mode of the information stream of the call as one or more of the following LINEMEDIAMODE_constants:

    • LINEMEDIAMODE_UNKNOWN
      A media stream exists but its mode is currently unknown and may become known later. This corresponds to a call with an unclassified media type. In typical analog telephony environments, the media mode of an incoming call may be unknown until after the call has been answered and the media stream has been filtered to make a determination.

      If the LINEMEDIAMODE_UNKNOWN flag is set, other media flags can also be set. This signifies that the media is unknown but that it is likely to be one of the other indicated media modes.

    • LINEMEDIAMODE_INTERACTIVEVOICE
      The presence of voice energy on the call, and the call is treated as an interactive call with humans on both ends.

    • LINEMEDIAMODE_AUTOMATEDVOICE
      The presence of voice energy on the call, and the voice is locally handled by an automated application.

    • LINEMEDIAMODE_DATAMODEM
      A data modem session on the call.

    • LINEMEDIAMODE_G3FAX
      A group 3 fax is being sent or received over the call.

    • LINEMEDIAMODE_G4FAX
      A group 4 fax is being sent or received over the call.

    • LINEMEDIAMODE_TDD
      A TDD (telecommunication device for the deaf) session on the call.

    • LINEMEDIAMODE_DIGITALDATA
      Digital data is being sent or received over the call.

    • LINEMEDIAMODE_TELETEX
      A teletex session on the call. (Teletex is one of the telematic services.)

    • LINEMEDIAMODE_VIDEOTEX
      A videotex session on the call. (Videotex is one the telematic services.)

    • LINEMEDIAMODE_TELEX
      A telex session on the call. (Telex is one of the telematic services.)

    • LINEMEDIAMODE_MIXED
      A mixed session on the call. (Mixed is one of the ISDN telematic services.)

    • LINEMEDIAMODE_ADSI
      An ADSI (Analog Display Services Interface) session on the call.

    • LINEMEDIAMODE_VOICEVIEW
      The media mode of the call is VoiceView.

Remarks

A client that uses the services of a call manager or integrated MCM driver that supports the CO_ADDRESS_FAMILY_TAPI_PROXY address family specifies TAPI SAP parameters in a CO_AF_TAPI_SAP structure. The client overlays this structure on CO_SAP. Sap[], specifies the SAP type in CO_SAP. SapType, and specifies the length of the Sap[] array in CO_SAP. SapLength. The client passes the CO_SAP structure to NdisClRegisterSap when registering a SAP with a call manager or an MCM driver.

Requirements

Header

Ndistapi.h (include Ndis.h)

See also

CO_SAP

CO_SPECIFIC_PARAMETERS

NdisClRegisterSap

ProtocolClRegisterSapComplete

ProtocolCmRegisterSap

 

 

Send comments about this topic to Microsoft