[警告: 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 に含まれる他の値の 1 つを返す場合があります。
備考
ドライバー 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 の