Partager via

NET_DEVICE_PNP_EVENT (Compact 2013)

  • Article

3/26/2014

This structure defines device plug and play (PnP) events for miniport adapters.

Syntax

typedef struct _NET_DEVICE_PNP_EVENT {
  NDIS_OBJECT_HEADER  Header;
  NDIS_PORT_NUMBER  PortNumber;
  NDIS_DEVICE_PNP_EVENT  DevicePnPEvent;
  PVOID  InformationBuffer;
  ULONG  InformationBufferLength;
  UCHAR  NdisReserved[2 * sizeof(PVOID)];
} NET_DEVICE_PNP_EVENT, *PNET_DEVICE_PNP_EVENT;

Members

  • Header
    The NDIS_OBJECT_HEADER structure for the NET_DEVICE_PNP_EVENT structure. NDIS sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NET_DEVICE_PNP_EVENT_REVISION_1, and the Size member to NDIS_SIZEOF_NET_DEVICE_PNP_EVENT_REVISION_1.
  • PortNumber
    The source port of the PnP event notification. If the status indication is not specific to a port, PortNumber is zero.

  • DevicePnPEvent
    An event code that describes the PnP event as one of the following:

    • NdisDevicePnPEventSurpriseRemoved
      Specifies that the specified miniport adapter has been unexpectedly removed from the system.
    • NdisDevicePnPEventPowerProfileChanged
      Specifies that the power profile of the host system has changed.

  • InformationBuffer
    A pointer to a buffer. If NDIS sets the DevicePnPEvent member to NdisDevicePnPEventPowerProfileChanged, this buffer will contain a ULONG that NDIS sets to one of the following values:

    • NdisPowerProfileBattery
      Specifies that the host system is running on battery power.
    • NdisPowerProfileAcOnline
      Specifies that the host system is running on AC power.

    If NDIS sets DevicePnPEvent to NdisDevicePnPEventSurpriseRemoved, InformationBuffer is NULL.

  • InformationBufferLength
    The length, in bytes, of the buffer in the InformationBuffer member.
  • NdisReserved
    Reserved for NDIS.

Remarks

To provide a device PnP event notification, NDIS passes a pointer to a NET_DEVICE_PNP_EVENT structure to the MiniportDevicePnPEventNotify or FilterDevicePnPEventNotify function.

Requirements

Header

ndis.h

See Also

Reference

Miniport Driver Structures
FilterDevicePnPEventNotify
MiniportDevicePnPEventNotify
NDIS_OBJECT_HEADER