функция обратного вызова EVT_WDF_IO_QUEUE_IO_DEFAULT (wdfio.h)

Статья
03/22/2025

[Применимо к KMDF и UMDF]

Функция обратного вызова событий драйвера EvtIoDefault обрабатывает указанный запрос ввода-вывода.

Синтаксис

EVT_WDF_IO_QUEUE_IO_DEFAULT EvtWdfIoQueueIoDefault;

void EvtWdfIoQueueIoDefault(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request
)
{...}

Параметры

[in] Queue

Дескриптор объекта очереди платформы, связанный с запросом ввода-вывода.

[in] Request

Дескриптор объекта запроса платформы.

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

Нет

Замечания

Драйвер регистрирует функцию обратного вызова EvtIoDefault при вызове WdfIoQueueCreate. Дополнительные сведения о вызове WdfIoQueueCreateсм. в создании очередей ввода-вывода.

Если драйвер зарегистрировал функцию обратного вызова EvtIoDefault для очереди ввода-вывода устройства, функция обратного вызова получает каждый запрос ввода-вывода из очереди, если не зарегистрированы функции обратного вызова для конкретного запроса. Дополнительные сведения о функциях обратного вызова для конкретного запроса см. в обработчиков запросов.

Функция обратного вызова драйвера EvtIoDefault также может получать запросы на создание файлов. Дополнительные сведения о получении запросов на создание файлов см. в разделе Framework File Objects.

Функция обратного вызова EvtIoDefault должна обрабатывать каждый полученный запрос ввода-вывода каким-то образом. Дополнительные сведения см. в запросов ввода-вывода.

Большинство операций ввода-вывода требуют входного буфера, выходного буфера или обоих операций. Сведения о том, как драйвер может получить доступ к буферам запроса, см. в доступ к буферам данных в Framework-Based драйверах.

Эта функция обратного вызова может вызываться в IRQL <= DISPATCH_LEVEL, если только ExecutionLevel член WDF_OBJECT_ATTRIBUTES устройства или WDF_OBJECT_ATTRIBUTES драйвера имеет значение WdfExecutionLevelPassive.

Если irQL PASSIVE_LEVEL, платформа вызывает функцию обратного вызова в критическом регионе.

Дополнительные сведения об уровнях IRQL для обработчиков запросов см. в использование автоматической синхронизации.

Функция обратного вызова драйвера EvtIoDefault не должна вызывать следующие методы объекта очереди:

WdfIoQueueDrainSynchronous

WdfIoQueuePurgeSynchronous

WdfIoQueueStopSynchronously

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
Заголовок	wdfio.h (include Wdf.h)
IRQL	<= DISPATCH_LEVEL (см. раздел "Примечания")