OID_TAPI_OPEN

  • Article

The OID_TAPI_OPEN OID requests the miniport driver to open the line device designated by the given device ID and return the NIC driver's handle for the device.

Support for this request is mandatory.

This request uses an NDIS_TAPI_OPEN structure, defined as follows:

typedef struct _NDIS_TAPI_OPEN {         
         IN ULONG ulRequestID;
         IN ULONG ulDeviceID;
         IN HTAPI_LINE htLine;
         OUT HDRV_LINE hdLine;
 } NDIS_TAPI_OPEN, *PNDIS_TAPI_OPEN;

The members of this structure contain the following information:

  • ulRequestID
    Reserved.

  • ulDeviceID
    Specifies the line device to be queried. This was set up in a preceding OID_TAPI_PROVIDER_INITIALIZE request.

  • htLine
    Specifies NDISTAPI's handle to the line device to be used in subsequent calls to the LINE_EVENT callback procedure to identify the line

  • hdLine
    Specifies the miniport driver's NIC driver handle to the line device.

    The NIC driver must fill this location with its handle for the line device to complete this request successfully. This handle is ignored if the miniport driver completes the request with an error status.

The MiniportQueryInformationfunction can return one of the following:

NDIS_STATUS_SUCCESS

NDIS_STATUS_PENDING

NDIS_STATUS_TAPI_ALLOCATED

NDIS_STATUS_TAPI_INVALMEDIAMODE

NDIS_STATUS_FAILURE

The miniport driver must retain the htLinehandle for the device provided by NDISTAPI for use in subsequent NDIS_TAPI_EVENTnotifications using the LINE_EVENT structure.

 

 

Send comments about this topic to Microsoft