IWDFRemoteTarget::Close 方法 (wudfddi.h)
[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1,且較新版本的 #D6C320934833046A29613E8EC96B6FB73 上,UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]
Close 方法會關閉遠端 I/O 目標。
Syntax
HRESULT Close();
傳回值
Close 方法一律會傳回S_OK。
備註
如果您的驅動程式提供 IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete 回呼函式,回呼函式必須呼叫 Close。
Close 方法會完成或取消驅動程式傳送至 I/O 目標的所有 I/O 要求。
驅動程式呼叫 Close 之後,驅動程式無法將 I/O 要求傳送至 I/O 目標。
如需 Close 方法的詳細資訊,請參閱 控制 UMDF 中的一般 I/O 目標狀態。
範例
下列程式代碼範例顯示呼叫 Close的 IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete 回調函式。
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 |