NdisFNetPnPEvent function

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(
  _In_  NDIS_HANDLE FilterModuleContext,
  _In_  PNET_PNP_EVENT_NOTIFICATION NetPnPEvent
);

Parameters

FilterModuleContext [in]

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

NetPnPEvent [in]

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 codeDescription
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

Version

Supported in NDIS 6.0 and later.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

DDI compliance rules

Irql_Filter_Driver_Function

See also

FilterAttach
FilterNetPnPEvent
FilterOidRequest
NET_PNP_EVENT_NOTIFICATION

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft