IWDFDevice2：：CreateRemoteTarget 方法 (wudfddi.h)

  • 项目

[警告： UMDF 2 是最新版本的 UMDF，并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]

CreateRemoteTarget 方法创建表示远程 I/O 目标的远程目标对象。

语法

HRESULT CreateRemoteTarget(
  [in, optional] IUnknown         *pCallbackInterface,
  [in, optional] IWDFObject       *pParentObject,
  [out]          IWDFRemoteTarget **ppRemoteTarget
);

参数

[in, optional] pCallbackInterface

指向驱动程序提供的可选回调接口的指针。 如果驱动程序支持该接口，则此接口的 IUnknown：：QueryInterface 方法必须返回指向驱动程序的 IRemoteTargetCallbackRemoval 接口的指针。 此参数是可选的，可以为 NULL。

[in, optional] pParentObject

指向框架对象的指针。 如果驱动程序提供此可选指针，则指定的 对象将成为新远程目标对象的父对象。 如果此参数为 NULL，则提供 IWDFDevice2 接口的设备对象将成为父级。 框架在删除父对象时会删除远程目标对象。

[out] ppRemoteTarget

指向位置的指针，该位置接收指向新远程目标对象的 IWDFRemoteTarget 接口的指针。

返回值

如果操作成功，CreateRemoteTarget 将返回S_OK。 否则，方法可能会返回以下值：

返回代码 说明
E_OUTOFMEMORY
 框架分配内存的尝试失败。
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)
pParentObject 参数未指定提供 IWDFDevice2 接口的设备对象或其父级链导致该对象的对象。
 

此方法可能返回 Winerror.h 包含的其他值之一。

注解

驱动程序调用 CreateRemoteTarget 后，驱动程序可以通过调用 IWDFRemoteTarget：：OpenRemoteInterface (打开 设备接口) 打开远程目标，或 调用 IWDFRemoteTarget：：OpenFileByName (打开文件) 。

如果驱动程序使用 pParentObject 参数指定父对象，则父对象可以是提供 IWDFDevice2 接口的设备对象，也可以是父级链指向该设备对象的任何对象。 框架会在 (远程目标对象时删除远程目标对象，或者驱动程序) 删除设备对象。

有关远程 I/O 目标的详细信息，请参阅 在 UMDF 中使用 I/O 目标。

示例

有关使用 CreateRemoteTarget 的代码示例，请参阅 IWDFDevice2：：CreateRemoteInterface 和 IWDFRemoteTarget：：OpenFileByName 中的代码示例。

要求

要求 值
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.9
标头 wudfddi.h (包括 Wudfddi.h)
DLL WUDFx.dll

另请参阅

IWDFDevice2

IWDFRemoteTarget：：OpenFileByName

IWDFRemoteTarget：：OpenRemoteInterface