Expand Minimize

NdisCompletePnPEvent function

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

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)

IRQL

PASSIVE_LEVEL.

See also

NET_PNP_EVENT
ProtocolPnPEvent

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft