共用方式為


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

另請參閱

IWDFRemoteTarget

IWDFRemoteTarget::CloseForQueryRemove