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 |
| ヘッダー | wudfddi.h (Wudfddi.h を含む) |
関連項目
IPnpCallbackRemoteInterfaceNotification の
IWDFDevice2::CreateRemoteInterface
IWDFDevice2::CreateRemoteTarget
IWDFRemoteInterfaceInitialize の