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 |