OID_TAPI_SET_STATUS_MESSAGES

  • Article

The OID_TAPI_SET_STATUS_MESSAGES OID requests the miniport driver to allow NDISTAPI to specify which notification messages the miniport driver should generate for events related to status changes for the specified line or any of its addresses.

By default, address-status and line-status reporting is initially disabled for a line.

Support for this request is mandatory.

This request uses an NDIS_TAPI_SET_STATUS_MESSAGES structure, defined as follows:

typedef struct _NDIS_TAPI_SET_STATUS_MESSAGES {         
         IN ULONG ulRequestID;
         IN HDRV_LINE hdLine;
         IN ULONG ulLineStates;
         IN ULONG ulAddressStates;
 } NDIS_TAPI_SET_STATUS_MESSAGES,   *PNDIS_TAPI_SET_STATUS_MESSAGES;

The members of this structure contain the following information:

  • ulRequestID
    Reserved.

  • hdLine
    Specifies the miniport driver's handle to the line device.

  • ulLineStates
    Specifies a bit array that identifies status changes for which messages should be sent to NDISTAPI. This parameter uses the LINEDEVSTATE constants. For more information, see ndistapi.h.

  • ulAddressStates
    Specifies a bit array that identifies which address status changes the miniport driver should monitor to send appropriate notifications to NDISTAPI. The value is an ORed combination of LINEADDRESSSTATE flags. For more information, see ndistapi.h.

The MiniportSetInformationfunction can return one of the following:

NDIS_STATUS_SUCCESS

NDIS_STATUS_PENDING

NDIS_STATUS_TAPI_INVALLINEHANDLE

NDIS_STATUS_TAPI_INVALLINESTATE

NDIS_STATUS_TAPI_RESOURCEUNAVAIL

NDIS_STATUS_FAILURE

 

 

Send comments about this topic to Microsoft