NdisCompletePnPEvent function

Article
06/19/2017

Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisCompletePnPEvent completes a protocol's response to a Plug and Play or Power Management event for which the protocol's ProtocolPnPEvent function previously returned NDIS_STATUS_PENDING.

Syntax

VOID NdisCompletePnPEvent(
  _In_ NDIS_STATUS    Status,
  _In_ NDIS_HANDLE    NdisBindingHandle,
  _In_ PNET_PNP_EVENT NetPnPEvent
);

Parameters

Status [in]
Specifies the protocol's response to the previously indicated Plug and Play or Power Management event. To succeed such an event, a protocol returns NDIS_STATUS_SUCCESS. A protocol should always succeed a NetEventQueryPower, a NetEventSetPower, a NetEventCancelRemoveDevice, a NetEventReconfigure, a NetEventBindList, a NetEventBindsComplete, or a NetEventPnPCapabilities. A protocol can fail a NetEventQueryRemoveDevice by returning any caller-determined NDIS_STATUS_XXX except NDIS_STATUS_PENDING.
NdisBindingHandle [in]
Specifies the handle returned by NdisOpenAdapter that identifies the target NIC or the virtual adapter of the next-lower driver to which the caller is bound.
NetPnPEvent [in]
Pointer to a buffered NET_PNP_EVENT structure that was passed in to the protocol's ProtocolPnPEvent function.

Return value

None

Remarks

When a protocol returns NDIS_STATUS_PENDING from its ProtocolPnPEvent function, it must eventually call NdisCompletePnPEvent to indicate its response to the given Plug and Play or Power Management request.

A protocol can fail a NetEventQueryRemoveDevice by returning NDIS_STATUS_FAILURE.

A protocol should always succeed a NetEventQueryPower, a NetEventSetPower, a NetEventCancelRemoveDevice, a NetEventReconfigure, a NetEventBindList, a NetEventBindsComplete, or a NetEventPnPCapabilities by returning NDIS_STATUS_SUCCESS:

Requirements

Target platform	Universal
Version	Not supported for NDIS 6.0 drivers in Windows Vista. Use NdisCompleteNetPnPEventinstead. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP.
Header	Ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL.