IWDFIoRequest2：：Reuse 方法 （wudfddi.h）
[警告： UMDF 2 是最新版本的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上對 UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱 開始使用 UMDF。]
重複使用 方法會重新初始化架構要求物件，以便重複使用它。
語法
void Reuse(
[in] HRESULT hrNewStatus
);
參數
[in] hrNewStatus
架構指派給要求的 HRESULT 型別狀態值。
傳回值
沒有
言論
如果架構型驅動程式呼叫 IWDFDevice：：CreateRequest 來建立要求對象，驅動程式就可以重複使用這些要求物件。 驅動程式也可以重複使用它們在其I/O 佇列中從架構接收的要求物件。
驅動程式可以在原始要求完成之後重複使用要求物件。 在驅動程式呼叫 重複使用之後，必須重新初始化要求的內容。
如果您想要重複使用的要求具有 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 |