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 目标的状态。

示例

下面的代码示例演示调用 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();
}

要求

另请参阅

IWDFRemoteTarget

IWDFRemoteTarget：：CloseForQueryRemove