OID_TAPI_GET_ADDRESS_ID

The OID_TAPI_GET_ADDRESS_ID OID requests the WAN NIC driver to return the address ID associated with the address in a different format on the specified line.

Support for this request is mandatory.

This request uses an NDIS_TAPI_GET_ADDRESS_ID structure, defined as follows:



typedef struct _NDIS_TAPI_GET_ADDRESS_ID {         
         IN ULONG ulRequestID;
         IN HDRV_LINE hdLine;
         OUT ULONG ulAddressID;
         IN ULONG ulAddressMode;
         IN ULONG ulAddressSize;
         IN CHAR szAddress[1];
 } NDIS_TAPI_GET_ADDRESS_ID,   *PNDIS_TAPI_GET_ADDRESS_ID;


The members of this structure contain the following information:

ulRequestID

Reserved.

hdLine

Specifies the miniport driver's handle to the line for which the address ID should be retrieved. This was set up in a preceding OID_TAPI_OPEN request.

ulAddressID

Specifies the requested address ID. The miniport driver fills in this member with the address ID corresponding to szAddress to complete this request successfully.

ulAddressMode

Specifies the address mode of the address contained in szAddress. This member can have only the following LINEADDRESSMODE flag set:

LINEADDRESSMODE_DIALABLEADDR

ulAddressSize

Specifies the size in bytes of the address in szAddress.

szAddress

Specifies the virtual address of variable-size structure containing an address assigned to the line device. The format of the address is determined by the ulAddressSize member. If it is LINEADDRESSMODE_DIALABLEADDR, szAddress uses the common dialable number format and is null terminated.

The MiniportQueryInformationfunction can return one of the following:

NDIS_STATUS_SUCCESS

NDIS_STATUS_PENDING

NDIS_STATUS_TAPI_INVALLINEHANDLE

NDIS_STATUS_TAPI_INVALADDRESS

NDIS_STATUS_TAPI_RESOURCEUNAVAIL

NDIS_STATUS_FAILURE

 

 

Send comments about this topic to Microsoft

Mostra:
© 2014 Microsoft