NET_PNP_EVENT_NOTIFICATION structure (ndis.h)

The NET_PNP_EVENT_NOTIFICATION structure describes a network Plug and Play (PnP) event, an NDIS PnP event, or a power management event.

Syntax

typedef struct _NET_PNP_EVENT_NOTIFICATION {
  NDIS_OBJECT_HEADER       Header;
  NDIS_PORT_NUMBER         PortNumber;
  NET_PNP_EVENT            NetPnPEvent;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_ID       SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NET_PNP_EVENT_NOTIFICATION, *PNET_PNP_EVENT_NOTIFICATION;

Members

Header

The NDIS_OBJECT_HEADER structure for the NET_PNP_EVENT_NOTIFICATION structure. NDIS sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NET_PNP_EVENT_NOTIFICATION_REVISION_1, and the Size member to NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.

PortNumber

The source port of the event notification. If the status indication is not specific to a port, PortNumber is zero.

NetPnPEvent

A NET_PNP_EVENT structure that describes the event.

Flags

Flags for this event notification.

Important

For miniport drivers calling NdisMNetPnPEvent, if VPortId is set to a value different from NDIS_DEFAULT_VPORT_ID then Flags must be set to NET_EVENT_FLAGS_VPORT_ID_VALID for VPortId to take effect.

Other values for Flags are reserved for NDIS.

SwitchId

An NDIS_NIC_SWITCH_ID value that specifies a switch identifier. The switch identifier is an integer between zero and the number of switches that the network adapter supports. An NDIS_DEFAULT_SWITCH_ID value indicates the default network adapter switch.

VPortId

An NDIS_NIC_SWITCH_VPORT_ID value that uniquely identifies the virtual port (VPort) on the network adapter.

A value of NDIS_DEFAULT_VPORT_ID specifies the default VPort on the switch. The default VPort is always attached to the PCI Express (PCIe) Physical Function (PF) of the network adapter.

Note

A nondefault VPort with the specified VPortId value must have previously been created through an OID method request of OID_NIC_SWITCH_CREATE_VPORT.

Remarks

When the operating system issues a system PnP event or a power management event to a target device object that represents an adapter, NDIS translates the event into a NET_PNP_EVENT_NOTIFICATION structure.

The NetPnPEvent member is a NET_PNP_EVENT structure. The NetEvent member of this NET_PNP_EVENT structure specifies an event code that identifies the network PnP event, NDIS PnP event, or power management event.

The Buffer member, which is in the NET_PNP_EVENT structure that is specified in the NetPnPEvent member of NET_PNP_EVENT_NOTIFICATION, specifies the address of a buffer that contains information that is specific to the event that is indicated by the NetEvent member.

NDIS also issues PnP event notifications for NDIS PnP events such as NetEventPause, NetEventRestart, NetEventPortActivation, and NetEventPortDeactivation.

NDIS passes a pointer to a NET_PNP_EVENT_NOTIFICATION structure to the FilterNetPnPEvent function of overlying filter drivers and to the ProtocolNetPnPEvent function of overlying protocol drivers.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.0 and later.
Header ndis.h (include Ndis.h)

See also

FilterNetPnPEvent

NDIS_OBJECT_HEADER

NET_PNP_EVENT

ProtocolNetPnPEvent