NDIS_TAPI_SET_STATUS_MESSAGES

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.

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Ntddndis.h and Ndistapi.h.

See Also

OID_TAPI_SET_STATUS_MESSAGES | MiniportSetInformation

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.