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

  • Статья

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

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

Синтаксис

EVT_WDF_IO_QUEUE_IO_WRITE EvtWdfIoQueueIoWrite;

void EvtWdfIoQueueIoWrite(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request,
  [in] size_t Length
)
{...}

Параметры

[in] Queue

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

[in] Request

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

[in] Length

Число записываемых байтов.

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

None

Remarks

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

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

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

Для запросов на запись требуется входной буфер, содержащий данные, получаемые драйвером. Сведения о том, как драйвер может получить доступ к буферу запроса на запись, см. в статье Доступ к буферам данных в Framework-Based Drivers.

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

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

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

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

WdfIoQueueDrainSynchronously
WdfIoQueuePurgeSynchronously
WdfIoQueueStopSynchronously

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfio.h (включая Wdf.h)
IRQL <= DISPATCH_LEVEL (см. раздел "Примечания")

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

EvtIoDefault

WDF_OBJECT_ATTRIBUTES

WdfIoQueueCreate