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

こちらもご覧ください

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest2

IWDFIoRequest::SetCompletionCallback