共用方式為

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。 否則，方法可能會傳回下列值：

傳回碼 Description
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