Метод IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent (wudfddi.h)

Статья
08/08/2023

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Функция обратного вызова события OnRemoteInterfaceEvent драйвера на основе UMDF обрабатывает события устройства, связанные с интерфейсом устройства.

Синтаксис

void OnRemoteInterfaceEvent(
  [in]           IWDFRemoteInterface *pWdfRemoteInterface,
  [in]           REFGUID             EventGuid,
  [in, optional] BYTE                *pbData,
  [in]           DWORD               cbDataSize,
  [in]           DWORD               NameBufferOffset
);

Параметры

[in] pWdfRemoteInterface

Указатель на интерфейс IWDFRemoteInterface объекта удаленного интерфейса, представляющего интерфейс устройства. Драйвер получает этот указатель при вызове IWDFDevice2::CreateRemoteInterface.

[in] EventGuid

Идентификатор GUID, определяющий тип события. Идентификаторы GUID событий определяются компонентами, поддерживающими такие идентификаторы GUID. Некоторые классы интерфейса устройства предоставляют идентификаторы GUID событий, а некоторые — пользовательские события.

[in, optional] pbData

Указатель на буфер, содержащий данные, относящиеся к событиям. Как правило, компоненты, определяющие GUID событий, также определяют структуры для буферов событий.

[in] cbDataSize

Размер (в байтах) буфера, на который указывает pbData .

[in] NameBufferOffset

Смещение (в байтах) от начала буфера, на который указывает pbData . Байты от 0 до NameBufferOffset-1 буфера содержат двоичные данные. Байты от NameBufferOffset до конца буфера содержат строковые данные в Юникоде.

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

None

Remarks

Функция обратного вызова события OnRemoteInterfaceEvent драйвера обрабатывает все события устройства, кроме событий прибытия и удаления. Такие события могут возникать из вызова драйвера на основе UMDF к IWDFDevice::P ostEvent или из вызова драйвера в режиме ядра IoReportTargetDeviceChange или IoReportTargetDeviceChangeAsynchronous.

Платформа начинает вызывать функцию обратного вызова события OnRemoteInterfaceEvent после вызова драйвером IWDFRemoteTarget::OpenRemoteInterface и продолжает вызывать функцию обратного вызова, пока удаленный целевой объект ввода-вывода интерфейса устройства не будет закрыт.

Дополнительные сведения о функции обратного вызова события OnRemoteInterfaceEvent драйвера см. в разделе Использование интерфейсов устройств в драйверах на основе UMDF.

Требования

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

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

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval

Поделиться через