NdisFNetPnPEvent function (ndis.h)

  • Article

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)

See also

FilterAttach

FilterNetPnPEvent

FilterOidRequest

NET_PNP_EVENT_NOTIFICATION