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);
}
...
要件
| 要件 | 値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| 対象プラットフォーム | デスクトップ |
| 最小 UMDF バージョン | 1.9 |
| Header | wudfddi.h (Wudfddi.h を含む) |
| [DLL] | WUDFx.dll |
こちらもご覧ください
IRequestCallbackRequestCompletion::OnCompletion
IWDFIoRequest::CompleteWithInformation