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

Статья
02/07/2025

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

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

Синтаксис

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. Некоторые классы интерфейсов устройств предоставляют идентификаторы идентификаторов событий, а некоторые драйверы предоставляют пользовательские события.

[in, optional] pbData

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

[in] cbDataSize

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

[in] NameBufferOffset

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

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

Никакой

Замечания

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

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

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

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.9
заголовка	wudfddi.h (include Wudfddi.h)

См. также

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval

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