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。 否则，该方法可能会返回以下值：
| 返回代码 | 描述 |
|---|---|
|
框架尝试分配内存失败。 |
|
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 |