IWDFIoRequest2::GetStatus 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
GetStatus 메서드는 I/O 요청의 상태를 반환합니다.
통사론
HRESULT GetStatus();
반환 값
GetStatus HRESULT 형식의 상태 값을 반환할 이 값은 IWDFIoRequest2 인터페이스가 나타내는 I/O 요청의 현재 상태를 나타냅니다.
발언
드라이버는 I/O 대상에 I/O 요청을 보내기 위해 IWDFIoRequest::Send 호출한 후 GetStatus 호출할 수 있습니다.
-
보내기 대한 드라이버의 호출이 성공하면 GetStatus 지정된 요청을 완료하는 드라이버에서 설정한 상태 값을 반환합니다.
드라이버가 보내기호출할 때 요청에 대한 WDF_REQUEST_SEND_OPTION_SYNCHRONOUS 지정하는 경우 드라이버는 보내기호출한 직후 GetStatus(또는 IWDFIoRequest::GetCompletionParams )을 호출할 수 있습니다.
드라이버가 보내기호출할 때 WDF_REQUEST_SEND_OPTION_SYNCHRONOUS 지정하지 않으면 일반적으로 드라이버는 IRequestCallbackRequestCompletion::OnCompletion 콜백 함수 내에서 GetStatus(또는 IWDFIoRequest::GetCompletionParams)를 호출합니다.
- 보내기 대한 드라이버의 호출이 실패하면 Send 프레임워크에서 오류를 설명하기 위해 설정한 상태 값을 반환합니다. 드라이버는 GetStatus(IWDFIoRequest::GetCompletionParams아님)를 호출하여 요청의 현재 상태를 가져올 수 있지만, 이 경우 GetStatus 반환된 송신 동일한 실패 코드를 반환합니다.
예제
다음 코드 예제에서는 I/O 요청을 I/O 대상으로 보냅니다. 보내기 호출이 성공하면 이 예제에서는 IWDFIoRequest2 인터페이스를 가져오고, GetStatus 호출하여 요청의 상태 값을 가져온 다음, IWDFIoRequest::CompleteWithInformation 호출하여 I/O 요청을 완료합니다.
HRESULT hrSend = S_OK;
...
hrSend = fxRequest->Send(m_pIoTarget,
WDF_REQUEST_SEND_OPTION_SYNCHRONOUS,
0);
if (SUCCEEDED(hrSend))
{
//
// If send succeeded, complete the request and specify
// the current status value.
//
CComQIPtr<IWDFIoRequest2> fxRequest2 = fxRequest;
hrSend = fxRequest2->GetStatus();
fxRequest->CompleteWithInformation(hrSend, 0);
}
...
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.9 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |
참고 항목
IRequestCallbackRequestCompletion::OnCompletion
IWDFIoRequest::CompleteWithInformation