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 佇列中架構收到的要求物件。

驅動程式可以在原始要求完成之後重複使用要求物件。 在驅動程式呼叫 [重複使用] 之後，必須重新初始化要求的內容。

如果您想要重複使用的要求具有 IRequestCallbackRequestCompletion：：OnCompletion 回呼函式，驅動程式必須在呼叫 Reuse 之後呼叫 IWDFIoRequest：：SetCompletionCallback。

如需 重複使用的詳細資訊，請參閱 重複使用 Framework 要求物件。

範例

下列程式代碼範例示範 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
標頭	wudfddi.h (包括 Wudfddi.h)
Dll	WUDFx.dll

另請參閱

IRequestCallbackRequestCompletion：：OnCompletion

IWDFIoRequest2

IWDFIoRequest：：SetCompletionCallback