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 ターゲットに送信できます。

• Send のドライバーの呼び出しが成功した場合、GetStatus は、指定された要求を完了するドライバーによって設定された状態値を返します。

  ドライバーが Send を呼び出すときに要求のWDF_REQUEST_SEND_OPTION_SYNCHRONOUSを指定した場合、ドライバーは Send を呼び出した直後に GetStatus (または IWDFIoRequest::GetCompletionParams) を呼び出すことができます。

  ドライバーが Send を呼び出すときにWDF_REQUEST_SEND_OPTION_SYNCHRONOUSを指定しない場合、ドライバーは通常、IRequestCallbackRequestCompletion::OnCompletion コールバック関数内から GetStatus (または IWDFIoRequest::GetCompletionParams) を呼び出します。

• ドライバーの Send の呼び出しが失敗した場合、Send は、フレームワークがエラーを説明するために設定した状態値を返します。 ドライバーは GetStatus (IWDFIoRequest::GetCompletionParams ではなく) を呼び出して要求の現在の状態を取得できますが、この場合、 GetStatus は Send が返したのと同じエラー コードを返します。

例

次のコード例では、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);
}
...

要件

こちらもご覧ください

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest2

IWDFIoRequest::CompleteWithInformation

IWDFIoRequest::GetCompletionParams

IWDFIoRequest::Send