Share via


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

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.

See also

NET_PNP_EVENT

ProtocolPnPEvent

 

 

Send comments about this topic to Microsoft