OID_TAPI_GET_ADDRESS_ID

  • Article

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