Hardware Dev Center

Collapse the table of content
Expand the table of content
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

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)

IRQL

PASSIVE_LEVEL.

See also

NET_PNP_EVENT
ProtocolPnPEvent

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft