IWDFRemoteTarget::Close 方法 (wudfddi.h)
[警告: UMDF 2 是最新版本的 UMDF,並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1,而且較新版本的 Windows 10 上對 UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱 開始使用 UMDF。]
Close 方法會關閉 遠端 I/O 目標。
語法
HRESULT Close();
傳回值
Close 方法一律會傳回S_OK。
言論
如果您的驅動程式提供 IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete 回呼函式,則回調函式必須呼叫 close 。
Close 方法會完成或取消驅動程式傳送至 I/O 目標的所有 I/O 要求。
在驅動程式呼叫 Close之後,驅動程式無法將 I/O 要求傳送至 I/O 目標。
如需 Close 方法的詳細資訊,請參閱 在 UMDF中控制一般 I/O 目標的狀態。
例子
下列程式代碼範例顯示 IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete 回呼函式,其會呼叫 close 。
VOID
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveComplete(
__in IWDFRemoteTarget *FxTarget
)
{
//
// Here, do any driver-specific actions that your driver requires
// to close the remote I/O target.
//
...
//
// Close the target.
//
FxTarget->Close();
}
要求
要求 | 價值 |
---|---|
終止支援 | UMDF 2.0 和更新版本中無法使用。 |
目標平臺 | 桌面 |
最低 UMDF 版本 | 1.9 |
標頭 | wudfddi.h (包括 Wudfddi.h) |
DLL | WUDFx.dll |