Share via


OID_TAPI_GET_ADDRESS_STATUS

The OID_TAPI_GET_ADDRESS_STATUS OID requests the miniport driver to return the current status for the specified address.

Support for this request is mandatory.

This request uses an NDIS_TAPI_GET_ADDRESS_STATUS structure, defined as follows, to query the current status for the specified address:

typedef struct _NDIS_TAPI_GET_ADDRESS_STATUS {         
         IN ULONG ulRequestID;
         IN HDRV_LINE hdLine;
         IN ULONG ulAddressID;
         OUT LINE_ADDRESS_STATUS LineAddressStatus;
 } NDIS_TAPI_GET_ADDRESS_STATUS,   *PNDIS_TAPI_GET_ADDRESS_STATUS;

The members of this structure contain the following information:

  • ulRequestID
    Reserved.

  • hdLine
    Specifies the miniport driver's handle for the line.

  • ulAddressID
    Specifies an address on the given open line device. This is the address for which the status should be returned. The value of this member is not validated by NDISTAPI when this request is made.

  • LineAddressStatus
    Specifies the virtural address of a variable-size structure of type LINE_ADDRESS_STATUS. For more information, see ndistapi.h.

    The miniport driver fills this structure with address status information to complete this request successfully.

    The LineAddressStatus member has at least sizeof(LINE_ADDRESS_STATUS) bytes reserved.

The MiniportQueryInformationfunction can return one of the following:

NDIS_STATUS_SUCCESS

NDIS_STATUS_PENDING

NDIS_STATUS_TAPI_INVALLINEHANDLE

NDIS_STATUS_TAPI_INVALADDRESSID

NDIS_STATUS_TAPI_RESOURCEUNAVAIL

NDIS_STATUS_FAILURE

 

 

Send comments about this topic to Microsoft