Перечисление WDF_REQUEST_TYPE (wudfddi_types.h)

Статья
08/08/2023

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

Перечисление WDF_REQUEST_TYPE определяет типы запросов ввода-вывода, которые может представлять объект запроса UMDF.

Синтаксис

typedef enum _WDF_REQUEST_TYPE {
  WdfRequestUndefined,
  WdfRequestCreate,
  WdfRequestCleanup,
  WdfRequestRead,
  WdfRequestWrite,
  WdfRequestDeviceIoControl,
  WdfRequestClose,
  WdfRequestUsb,
  WdfRequestOther,
  WdfRequestInternalIoctl,
  WdfRequestTypeNoFormat,
  WdfRequestFlushBuffers,
  WdfRequestQueryInformation,
  WdfRequestSetInformation,
  WdfRequestMaximum
} WDF_REQUEST_TYPE, *PWDF_REQUEST_TYPE;

Константы


`WdfRequestUndefined` Тип объекта запроса не определен.
`WdfRequestCreate` Объект запроса представляет запрос на создание файла. Драйвер получает объект запроса этого типа, когда приложение открывает устройство путем вызова функции Microsoft Win32 CreateFile . Платформа доставляет этот тип запроса вместе с вновь созданным объектом файла (IWDFFile) в функцию обратного вызова IQueueCallbackCreate::OnCreateFile драйвера. Новый объект file представляет дескриптор файла с типом HANDLE, который возвращает Win32 CreateFile .
`WdfRequestCleanup` Объект запроса представляет запрос на очистку файла. Драйвер получает объект запроса этого типа после того, как вызов приложения функции Win32 CloseHandle закрывает последний дескриптор для объекта файла, но, возможно, до завершения или отмены всех незавершенных запросов ввода-вывода файла. Платформа доставляет этот тип запроса функции обратного вызова IFileCallbackCleanup::OnCleanupFile драйвера. (См. также WdfRequestClose.)
`WdfRequestRead` Объект запроса представляет запрос на чтение. Этот драйвер получает этот тип запроса ввода-вывода, когда приложение вызывает функцию Win32 ReadFile или ReadFileEx . Платформа доставляет этот тип запроса функции обратного вызова IQueueCallbackRead::OnRead драйвера.
`WdfRequestWrite` Объект запроса представляет запрос на запись. Этот драйвер получает такой тип запроса ввода-вывода, когда приложение вызывает функцию Win32 WriteFile или WriteFileEx . Платформа доставляет этот тип запроса функции обратного вызова IQueueCallbackWrite::OnWrite драйвера.
`WdfRequestDeviceIoControl` Объект запроса представляет запрос управления вводом-выводом устройства. Этот драйвер получает такой тип запроса ввода-вывода, когда приложение вызывает функцию Win32 DeviceIoControl . Платформа доставляет этот тип запроса функции обратного вызова IQueueCallbackDeviceIoControl::OnDeviceIoControl драйвера.
`WdfRequestClose` Объект запроса представляет запрос на закрытие файла. Драйвер получает объект запроса этого типа после того, как вызов приложения функции Win32 CloseHandle закрывает последний дескриптор для объекта файла и после завершения или отмены всех незавершенных запросов ввода-вывода файла. Платформа доставляет этот тип запроса в функцию обратного вызова IFileCallbackClose::OnCloseFile драйвера. (См. также WdfRequestCleanup.)
`WdfRequestUsb` Объект запроса был отправлен на USB-порт. Метод IWDFRequestCompletionParams::GetCompletedRequestType может возвращать это значение.
`WdfRequestOther` Это значение зарезервировано только для внутреннего использования.
`WdfRequestInternalIoctl` Это значение зарезервировано только для внутреннего использования.
`WdfRequestTypeNoFormat` Тип объекта запроса не указан.
`WdfRequestFlushBuffers` Объект запроса представляет запрос на очистку кэшированных буферов. Платформа доставляет этот тип запроса функции обратного вызова IQueueCallbackDefaultIoHandler::OnDefaultIoHandler драйвера.
`WdfRequestQueryInformation` Объект запроса представляет запрос на получение сведений о файле. Платформа доставляет этот тип запроса функции обратного вызова IQueueCallbackDefaultIoHandler::OnDefaultIoHandler драйвера.
`WdfRequestSetInformation` Объект запроса представляет запрос на настройку сведений о файле. Платформа доставляет этот тип запроса функции обратного вызова IQueueCallbackDefaultIoHandler::OnDefaultIoHandler драйвера.
`WdfRequestMaximum` Превышено максимальное значение перечисления.

Перечисление WDF_REQUEST_TYPE используется в качестве входного параметра IWDFDevice::ConfigureRequestDispatching и IWDFIoQueue::ConfigureRequestDispatching. Он также используется для возвращаемого значения IWDFIoRequest::GetType и IWDFRequestCompletionParams::GetCompletedRequestType.

Версию KMDF этого перечисления см. в разделе WDF_REQUEST_TYPE.