Метод 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 , который идентифицирует интерфейс устройства, который поступил.

Возвращаемое значение

None

Remarks

Драйвер на основе UMDF может зарегистрировать свою необязательную функцию обратного вызова события OnRemoteInterfaceArrival , вызвав IWDFDevice2::RegisterRemoteInterfaceNotification.

Драйвер может использовать методы интерфейса IWDFRemoteInterfaceInitialize , чтобы определить, какой интерфейс устройства поступил.

Прежде чем драйвер сможет отправлять запросы ввода-вывода в интерфейс устройства, он должен выполнить следующие действия:

  1. Вызовите IWDFDevice2::CreateRemoteInterface , чтобы создать объект удаленного интерфейса.
  2. Вызовите IWDFDevice2::CreateRemoteTarget , чтобы создать удаленный целевой объект.
  3. Вызовите IWDFRemoteTarget::OpenRemoteInterface , чтобы подключить объект интерфейса к удаленному целевому объекту и открыть удаленный целевой объект для операций ввода-вывода.
Дополнительные сведения об использовании объектов удаленного интерфейса для доступа к интерфейсам устройств см. в статье Использование интерфейсов устройств в драйверах на основе UMDF.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1,9
Верхняя часть wudfddi.h (включая Wudfddi.h)

См. также раздел

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface