NDIS_TAPI_OPEN (Windows Embedded CE 6.0)

1/6/2010

The NDIS_TAPI_OPEN structure is used by OID_TAPI_OPEN when it requests the miniport driver to open the line device designated by the given device identifier and return the NIC driver's handle for the device.

Support for this request is mandatory.

Syntax

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

Members

• ulRequestID
  [in] Reserved.

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

• htLine
  [in] 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
  [out] 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 completes the request with an error status.

Remarks

The MiniportQueryInformation function 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 htLine handle for the device provided by NDISTAPI for use in subsequent NDIS_TAPI_EVENT notifications using the LINE_EVENT structure.

Requirements

See Also

Reference

NDIS Structures
OID_TAPI_OPEN
OID_TAPI_PROVIDER_INITIALIZE
MiniportQueryInformation