Метод IQueueCallbackWrite::OnWrite (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Метод OnWrite вызывается для обработки запроса на запись, когда приложение записывает сведения на устройство через функцию WriteFile Microsoft Win32 или WriteFileEx.
Синтаксис
void OnWrite(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest,
[in] SIZE_T NumOfBytesToWrite
);
Параметры
[in] pWdfQueue
Указатель на интерфейс IWDFIoQueue для объекта очереди ввода-вывода, из который поступает запрос.
[in] pWdfRequest
Указатель на интерфейс IWDFIoRequest, представляющий объект запроса платформы.
[in] NumOfBytesToWrite
Размер буфера записи в байтах для запроса.
Возвращаемое значение
Никакой
Замечания
Драйвер регистрирует интерфейс IQueueCallbackWrite, когда драйвер вызывает метод IWDFDevice::CreateIoQueue для создания очереди ввода-вывода или настройки очереди ввода-вывода по умолчанию.
Драйвер может реализовать один метод OnWrite для всех очередей ввода-вывода или отдельных методов OnWrite для каждой очереди ввода-вывода.
Метод OnWrite получает каждый тип запроса записи из очереди. (Тип запроса записи определяется значением WdfRequestWrite типа перечисления WDF_REQUEST_TYPE для запроса.) Метод OnWrite должен обрабатывать каждый полученный запрос на запись. Дополнительные сведения о том, как драйверы UMDF обрабатывают запросы ввода-вывода, см. в обработки запросов ввода-вывода.
Драйвер может вызывать методы IWDFIoRequest::GetWriteParameters и методы IWDFIoRequest::GetInputMemory для получения сведений о запросе и буфере записи.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Виндоус |
| заголовка | wudfddi.h (include Wudfddi.h) |