次の方法で共有

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 コールバック関数を する場合は、の再利用呼び出した後、ドライバーは IWDFIoRequest::SetCompletionCallback を呼び出す必要があります。

再利用の詳細については、「フレームワーク要求オブジェクトの再利用」を参照してください。

例

次のコード例は、IRequestCallbackRequestCompletion::OnCompletion コールバック関数が IWDFIoRequest2 インターフェイスを取得し、再利用呼び出す方法を示しています。

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
ヘッダー wudfddi.h (Wudfddi.h を含む)
DLL WUDFx.dll

関連項目

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest2 の

IWDFIoRequest::SetCompletionCallback