CO_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_SAP structure specifies a Service Access Point (SAP) on which a connection-oriented client can receive incoming calls.
Syntax
typedef struct {
ULONG SapType;
ULONG SapLength;
UCHAR Sap[1];
} CO_SAP, *PCO_SAP;
Members
SapType
Specifies the format of the SAP address:Value Meaning NSAP Specifies an OSI SAP, which is a 20-octet hexadecimal address.
E164 Specifies an E.164 SAP, which is a 0-15-digit decimal address.
AF_TAPI_SAP_TYPE Specifies a SAP used for TAPI calls.
SapLength
Specifies the size in bytes of the structure at Sap.Sap
Specifies a variable-length array that contains the SAP information. The number and type of elements is defined by the call manager for the address family opened by the client.
Remarks
A connection-oriented client registers a SAP with a call manager by passing a CO_SAP structure in a call to NdisClRegisterSap. NDIS forwards the SAP information to the call manager's ProtocolCmRegisterSap function for validation. The SAP format is medium-dependent and specific to the address family supported by the call manager. If the SAP is already in use or if the call manager does not recognize the client-supplied specification at Sap, ProtocolCmRegisterSap fails the call, and NdisClRegisterSap propagates the failure back to the client.
After a client has successfully registered a SAP, the call manager notifies the client of incoming calls on that SAP. A client can register more than one SAP with a call manager.
SapType is meaningful only to the client and to the call manager or integrated miniport driver call manager (MCM) driver with which the client registers the SAP. The client can therefore set SapType to a driver-defined value that is recognized by the call manager or MCM driver.
Requirements
Header |
Ndis.h (include Ndis.h) |
See also