IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival メソッド (wudfddi.h)

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。

ドライバーの OnRemoteInterfaceArrival イベント コールバック関数は、 デバイス インターフェイス が使用可能になったときにドライバーに通知します。

構文

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

パラメーター

[in] pWdfRemoteInterfaceInit

到着したデバイス インターフェイスを識別する IWDFRemoteInterfaceInitialize インターフェイスへのポインター。

戻り値

なし

解説

UMDF ベースのドライバーは、IWDFDevice2::RegisterRemoteInterfaceNotification を呼び出すことによって、オプションの OnRemoteInterfaceArrival イベント コールバック関数を登録できます。

ドライバーは、 IWDFRemoteInterfaceInitialize インターフェイスのメソッドを使用して、どのデバイス インターフェイスが到着したかを判断できます。

ドライバーがデバイス インターフェイスに I/O 要求を送信する前に、ドライバーは次の操作を行う必要があります。

1. IWDFDevice2::CreateRemoteInterface を呼び出して、リモート インターフェイス オブジェクトを作成します。
2. IWDFDevice2::CreateRemoteTarget を呼び出して、リモート ターゲット オブジェクトを作成します。
3. IWDFRemoteTarget::OpenRemoteInterface を呼び出して、インターフェイス オブジェクトをリモート ターゲット オブジェクトに接続し、I/O 操作用にリモート ターゲットを開きます。

リモート インターフェイス オブジェクトを使用してデバイス インターフェイスにアクセスする方法の詳細については、「UMDF ベースのドライバーでのデバイス インターフェイスの使用」を参照してください。

要件

要件	値
サポート終了	UMDF 2.0 以降では使用できません。
対象プラットフォーム	デスクトップ
最小 UMDF バージョン	1.9
Header	wudfddi.h (Wudfddi.h を含む)

こちらもご覧ください

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface