Метод IQueueCallbackRead::OnRead (wudfddi.h)

Статья
08/08/2023

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

Метод OnRead вызывается для обработки запроса на чтение, когда приложение считывает информацию с устройства через функцию Microsoft Win32 ReadFile или ReadFileEx.

Синтаксис

void OnRead(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToRead
);

Параметры

[in] pWdfQueue

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

[in] pWdfRequest

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

[in] NumOfBytesToRead

Размер буфера чтения в байтах для запроса.

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

Никакой

Замечания

Драйвер регистрирует интерфейс IQueueCallbackRead, когда драйвер вызывает метод IWDFDevice::CreateIoQueue для создания очереди ввода-вывода или настройки очереди ввода-вывода по умолчанию.

Драйвер может реализовать один метод OnRead для всех очередей ввода-вывода или отдельных методов OnRead для каждой очереди ввода-вывода.

Метод OnRead получает каждый тип запроса чтения из очереди. (Тип запроса чтения определяется значением WdfRequestRead типа перечисления WDF_REQUEST_TYPE для запроса.) Метод OnRead должен обрабатывать каждый полученный запрос на чтение. Дополнительные сведения о том, как драйверы UMDF обрабатывают запросы ввода-вывода, см. в обработки запросов ввода-вывода.

Драйвер может вызывать методы IWDFIoRequest::GetReadParameters и методы IWDFIoRequest::GetOutputMemory для получения сведений о запросе и буфере чтения.