IWDFIoRequest2::Reuse メソッド (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。
Reuse メソッドは、フレームワーク要求オブジェクトを再利用できるように再初期化します。
構文
void Reuse(
[in] HRESULT hrNewStatus
);
パラメーター
[in] hrNewStatus
フレームワークが要求に割り当てる HRESULT 型の状態値。
戻り値
なし
解説
フレームワーク ベースのドライバーが IWDFDevice::CreateRequest を呼び出して要求オブジェクトを作成した場合、ドライバーはこれらの要求オブジェクトを再利用できます。 ドライバーは、フレームワークから受信した要求オブジェクトを I/O キューで再利用することもできます。
ドライバーは、元の要求が完了した後に要求オブジェクトを再利用できます。 ドライバーが Reuse を呼び出した後、要求の内容を再初期化する必要があります。
再利用された要求に IRequestCallbackRequestCompletion::OnCompletion コールバック関数を含める場合、ドライバーは Reuse を呼び出した後に IWDFIoRequest::SetCompletionCallback を呼び出す必要があります。
再利用の詳細については、「フレームワーク要求オブジェクトの再利用」を参照してください。
例
次のコード例は、 IRequestCallbackRequestCompletion::OnCompletion コールバック関数が IWDFIoRequest2 インターフェイスを取得し、 Reuse を呼び出す方法を示しています。
void
STDMETHODCALLTYPE
CMyRemoteDevice::OnCompletion(
__in IWDFIoRequest* FxRequest,
__in IWDFIoTarget* FxTarget,
__in IWDFRequestCompletionParams* Params,
__in void* Context
)
{
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->Reuse(S_OK);
...
}
要件
| 要件 | 値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| 対象プラットフォーム | デスクトップ |
| 最小 UMDF バージョン | 1.9 |
| Header | wudfddi.h (Wudfddi.h を含む) |
| [DLL] | WUDFx.dll |