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
Header	wudfddi.h (Wudfddi.h を含む)
[DLL]	WUDFx.dll

こちらもご覧ください

IWDFDevice2

IWDFRemoteTarget::OpenFileByName

IWDFRemoteTarget::OpenRemoteInterface