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 요청의 현재 상태 나타냅니다.

설명

드라이버는 IWDFIoRequest::Send를 호출한 후 GetStatus를 호출하여 I/O 대상에 I/O 요청을 보낼 수 있습니다.

• 보내기에 대한 드라이버의 호출이 성공하면 GetStatus는 지정된 요청을 완료하는 드라이버에서 설정한 상태 값을 반환합니다.

  드라이버가 Send를 호출할 때 요청에 대한 WDF_REQUEST_SEND_OPTION_SYNCHRONOUS 지정하는 경우 드라이버는 Send를 호출한 직후 GetStatus(또는 IWDFIoRequest::GetCompletionParams)를 호출할 수 있습니다.

  드라이버가 Send를 호출할 때 WDF_REQUEST_SEND_OPTION_SYNCHRONOUS 지정하지 않으면 드라이버는 일반적으로 IRequestCallbackRequestCompletion::OnCompletion 콜백 함수 내에서 GetStatus(또는 IWDFIoRequest::GetCompletionParams)를 호출합니다.

• 보내기에 대한 드라이버의 호출이 실패하면 Send는 프레임워크가 오류를 설명하기 위해 설정한 상태 값을 반환합니다. 드라이버는 GetStatus(IWDFIoRequest::GetCompletionParams 아님)를 호출하여 요청의 현재 상태 가져올 수 있지만, 이 경우 GetStatus는 Send가 반환한 것과 동일한 실패 코드를 반환합니다.

요청 완료에 대한 자세한 내용은 I/O 요청 완료를 참조하세요.

예제

다음 코드 예제에서는 I/O 요청을 I/O 대상에 보냅니다. Send 호출이 성공하면 이 예제에서는 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

IWDFIoRequest2

IWDFIoRequest::CompleteWithInformation

IWDFIoRequest::GetCompletionParams

IWDFIoRequest::Send