OID_TAPI_PROVIDER_INITIALIZE

OID_TAPI_PROVIDER_INITIALIZE

The OID_TAPI_PROVIDER_INITIALIZE OID requests that the miniport driver initialize itself as a TAPI provider. The driver should set up whatever internal state it uses to track incoming requests from TAPI.

Support for this request is mandatory.

This request uses an NDIS_TAPI_PROVIDER_INITITIALIZE structure, defined as follows:



typedef struct _NDIS_TAPI_PROVIDER_INITIALIZE {         
         IN ULONG ulRequestID;
         IN ULONG ulDeviceIDBase;
         OUT ULONG ulNumLineDevs;
         OUT ULONG ulProviderID;
 } NDIS_TAPI_PROVIDER_INITIALIZE,   *PNDIS_TAPI_PROVIDER_INITIALIZE;


The members of this structure contain the following information:

ulRequestID

Reserved.

ulDeviceIDBase

Specifies the lowest device ID for the line devices supported by the miniport driver. Subsequent to this request, the driver uses this value as the zero-based line device identifier value. That is, if ulNumLineDevs is greater than one, the ulDeviceID values subsequently passed in requests such as OID_TAPI_OPEN, contains this value for the first line, this value plus one for the second line, and so forth.

ulNumLineDevs

Specifies the number of line devices supported by the miniport driver to complete this request successfully.

ulProviderID

Specifies an ID for the WAN NIC driver if this request is completed successfully. This value must be unique within the set of WAN drivers that support TAPI; the NdisMiniportContext handle passed in to the MiniportInitialize function can be used to provide a guaranteed unique value.

The MiniportQueryInformationfunction can return one of the following:

NDIS_STATUS_SUCCESS

NDIS_STATUS_PENDING

NDIS_STATUS_TAPI_RESOURCEUNAVAIL

NDIS_STATUS_FAILURE

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft