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 要求を送信する前に、ドライバーは次の操作を行う必要があります。
- IWDFDevice2::CreateRemoteInterface を呼び出して、リモート インターフェイス オブジェクトを作成します。
- IWDFDevice2::CreateRemoteTarget を呼び出して、リモート ターゲット オブジェクトを作成します。
- IWDFRemoteTarget::OpenRemoteInterface を呼び出して、インターフェイス オブジェクトをリモート ターゲット オブジェクトに接続し、I/O 操作用にリモート ターゲットを開きます。
要件
| 要件 | 値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| 対象プラットフォーム | デスクトップ |
| 最小 UMDF バージョン | 1.9 |
| Header | wudfddi.h (Wudfddi.h を含む) |
こちらもご覧ください
IPnpCallbackRemoteInterfaceNotification
IWDFDevice2::CreateRemoteInterface