NDIS_TAPI_SET_STATUS_MESSAGES (Compact 2013)

  • Articolo

3/26/2014

The NDIS_TAPI_SET_STATUS_MESSAGES structure is used by OID_TAPI_SET_STATUS_MESSAGES when it 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.

Syntax

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

Members

  • ulRequestID
    [in] Reserved.
  • hdLine
    [in] Specifies the miniport driver's handle to the line device.
  • ulLineStates
    [in] Specifies a bit array that identifies status changes for which messages should be sent to NDISTAPI. This parameter uses the LINEDEVSTATE constants.
  • ulAddressStates
    [in] 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.

Remarks

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

Requirements

Header

ndistapi.h,
ntddndis.h

See Also

Reference

NDIS 5.x Legacy Structures
OID_TAPI_SET_STATUS_MESSAGES
MiniportSetInformation