NdisCompletePnPEvent

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

NdisCompletePnPEvent함수는 프로토콜의 ProtocolPnPEvent함수가 이전에 NDIS_STATUS_PENDING를 리턴한것에대한 PnP혹은 파워 매니지먼트 이벤트에대한 프로토콜의 응답을 완료한다.

매개변수

Status

이전에 PnP혹은 파워 매니지먼트 이벤트를 인디케이트하느것에대한 프로토콜의 응답을 지정한다. 그런 이벤트를 성공하기위해, 프로토콜은 NDIS_STATUS_SUCCESS를 리턴한다. 프로토콜은 항상 NetEventQueryPower,NetEventSetPower, a NetEventCancelRemoveDevice, a NetEventReconfigure, a NetEventBindList, a NetEventBindsComplete, 혹은 a NetEventPnPCapabilities 를 성공해야한다. 프로토콜은 호출자 의존의 NDIS_STATUS_PENDING를 제외한 NDIS_STATUS_XXX를 리턴함에의해 NetEventQueryRemoveDevice를 실패할수 있다.

NdisBindingHandle

호출자가 바인딩한 다음 하위 드라이버의 가상 아답터 혹은 목표 닉을 확인하는 NdisOpenAdapter함수에의해 리턴된 핸들을 지정한다.

NetPnPEvent

프로토콜의 ProtocolPnPEvent함수로 넘겨지는 버퍼화된 NET_PNP_EVENT에대한 포인터.

주석

프로토콜이 프로토콜의 ProtocolPnPEvent함수로부터 NDIS_STATUS_PENDING을 리턴할때, 결국 주어진 PnP 혹은 파워 매니저먼트에대한 응답을 가리키기위해 NdisCompletePnPEvent함수를 호출해야만 한다.

프로토콜은 NDIS_STATUS_FAILURE를 리턴함에의해 NetEventQueryRemoveDevice를 실패할수 있다.

프로토콜은 NDIS_STATUS_SUCCESS를 리턴함으로써 NetEventQueryPower, a NetEventSetPower, a NetEventCancelRemoveDevice, a NetEventReconfigure, a NetEventBindList, a NetEventBindsComplete, or a NetEventPnPCapabilities 를 성공해야 한다.

NdisCompletePnPEvent 함수의 호출자는 IRQL PASSIVE_LEVEL에서 동작 한다.