TdiPnPPowerComplete

VOID
   TdiPnPPowerComplete(
       IN HANDLE BindingHandle,
       IN PNET_PNP_EVENT PowerEvent,
       IN NTSTATUS Status
       );

TdiPnPPowerComplete 함수는 클라이언트가 TDI로 원래 STATUS_PENDING을 리턴하기 위해서 전원상태 변화통보의 진행을 완료했음을 알린다.

매개변수

BindingHandle

TdiRegisterPnPHandlers 함수로의 앞선 호출에서 리턴된 핸들을 서술한다.

PowerEvent

ClientPnPPowerChange 루틴에 대한 입력 매개변수로 전달되는 NET_PNP_EVENT 구조체의 포인터를 가리킨다.

Status

클라이언트가 이전에 STATUS_PENDING을 리턴한 것에 대해서 전원상태 변화연산의 마지막 상태를 서술한다.

주석

입력 상태가 STATUS_SUCCESS 이외의 다른 상태라면 TdiPnPPowerComplete 함수는 전원상태를 변화하는 시도가 실패한 트랜스포트를 알린다. TDI 클라이언트 중 하나가 정당한 이유로 전원상태 변화를 거절했을 때 TDI 클라이언트는 Status에 STATUS_FILES_OPEN 혹은 STATUS_UNSUCCESSFUL 같은 에러 상태를 리턴한다. 예를들어 어플리케이션에서 TDI 클라이언트로의 그러한 실패는 하부의 NIC 제거 취소에 대한 사용자 응답으로 진행중인 네트웍 전송을 장치 제거가 타협하는 마지막 사용자 경고에 대한 팝업을 보낸다는 것을 의미한다.

TdiPnPPowerComplete 함수의 호출자에 대해서 STATUS_PENDING을 리턴하는 것은 프로그래밍 에러이다.

TdiPnPPowerComplete 함수의 호출자는 IRQL < DISPATCH_LEVEL에서 실행되어야한다.