NdisFNetPnPEvent function (ndis.h)

Article
02/22/2024

A filter driver can call the NdisFNetPnPEvent function to forward a network Plug and Play (PnP) or Power Management event to overlying drivers.

Syntax

NDIS_STATUS NdisFNetPnPEvent(
  NDIS_HANDLE                 NdisFilterHandle,
  PNET_PNP_EVENT_NOTIFICATION NetPnPEventNotification
);

Parameters

NdisFilterHandle

A handle to the context area for the filter module. The filter driver created and initialized this context area in the FilterAttach function.

NetPnPEventNotification

A pointer to a NET_PNP_EVENT_NOTIFICATION structure, which describes the network PnP event or Power Management event being forwarded by the filter driver.

Return value

NdisFNetPnPEvent can return either of the following:

Return code	Description
NDIS_STATUS_SUCCESS	The overlying driver succeeded in processing the PnP event.
NDIS_STATUS_FAILURE	The overlying driver failed the PnP event.

Remarks

NDIS calls a filter driver's FilterNetPnPEvent function to notify the filter driver of network PnP and Power Management events.

Filter drivers can forward these notifications to overlying drivers. To forward a request, call the NdisFNetPnPEvent function from FilterNetPnPEvent.

Note NDIS drivers must not call NdisFNetPnPEvent from within the context of the FilterOidRequest function.

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Target Platform	Desktop
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI compliance rules	Irql_Filter_Driver_Function(ndis)