Share via


NDIS_TAPI_GET_ADDRESS_ID (Windows Embedded CE 6.0)

1/6/2010

The NDIS_TAPI_GET_ADDRESS_ID structure is used by OID_TAPI_GET_ADDRESS_ID when it requests the WAN NIC driver to return the address identifier associated with the address in a different format on the specified line.

Support for this request is mandatory.

Syntax

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

Members

  • ulRequestID
    [in] Reserved.
  • hdLine
    [in] Specifies the miniport driver's handle to the line for which the address identifier should be retrieved. This was set up in a preceding OID_TAPI_OPEN request.
  • ulAddressID
    [out] Specifies the requested address identifier. The miniport driver fills in this member with the address identifier corresponding to szAddress to complete this request successfully.
  • ulAddressMode
    [in] Specifies the address mode of the address contained in szAddress. This member can have only the following LINEADDRESSMODE flag set:

    LINEADDRESSMODE_DIALABLEADDR 
    
  • ulAddressSize
    [in] Specifies the size in bytes of the address in szAddress.
  • szAddress
    [in] 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 ulAddressMode member. If it is LINEADDRESSMODE_DIALABLEADDR, szAddress uses the common dialable number format and is zero-terminated.

Remarks

The MiniportQueryInformation function 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

Requirements

Header ndistapi.h, ntddndis.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

NDIS Structures
OID_TAPI_GET_ADDRESS_ID
OID_TAPI_OPEN
MiniportQueryInformation