Метод IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Функция обратного вызова событий драйвера OnRemoteInterfaceArrival сообщает драйверу, когда доступен интерфейс устройства .
Синтаксис
void OnRemoteInterfaceArrival(
[in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);
Параметры
[in] pWdfRemoteInterfaceInit
Указатель на интерфейс IWDFRemoteInterfaceInitialize, определяющий интерфейс устройства, который прибыл.
Возвращаемое значение
Никакой
Замечания
Драйвер на основе UMDF может зарегистрировать необязательный OnRemoteInterfaceArrival функцию обратного вызова событий путем вызова IWDFDevice2::RegisterRemoteInterfaceNotification.
Драйвер может использовать методы интерфейса IWDFRemoteInterfaceInitialize, чтобы определить, какой интерфейс устройства прибыл.
Прежде чем драйвер сможет отправить запросы ввода-вывода в интерфейс устройства, драйвер должен выполнить следующее:
- Вызовите IWDFDevice2::CreateRemoteInterface для создания объекта удаленного интерфейса.
- Вызовите IWDFDevice2::CreateRemoteTarget для создания удаленного целевого объекта.
- Вызовите IWDFRemoteTarget::OpenRemoteInterface, чтобы подключить объект интерфейса к удаленному целевому объекту и открыть удаленный целевой объект для операций ввода-вывода.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.9 |
| заголовка | wudfddi.h (include Wudfddi.h) |
См. также
IPnpCallbackRemoteInterfaceNotification
IWDFDevice2::CreateRemoteInterface