структура WDF_IO_TYPE_CONFIG (wdfdevice.h)

  • Статья

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

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

Синтаксис

typedef struct _WDF_IO_TYPE_CONFIG {
  ULONG              Size;
  WDF_DEVICE_IO_TYPE ReadWriteIoType;
  WDF_DEVICE_IO_TYPE DeviceControlIoType;
  ULONG              DirectTransferThreshold;
} WDF_IO_TYPE_CONFIG, *PWDF_IO_TYPE_CONFIG;

Члены

Size

Размер этой структуры в байтах.

ReadWriteIoType

KMDF Перечислитель WDF_DEVICE_IO_TYPE, который определяет метод, который драйвер будет использовать для доступа к буферам данных, которые он получает для запросов на чтение и запись.

UMDF Перечислитель WDF_DEVICE_IO_TYPE, который определяет метод, который драйвер предпочитает использовать для доступа к буферам данных запросов на чтение и запись. Допустимые значения: WdfDeviceIoBuffered и WdfDeviceIoDirect.

DeviceControlIoType

Этот элемент не применяется к KMDF.

UMDF Перечислитель WDF_DEVICE_IO_TYPE, который определяет метод, который драйвер предпочитает использовать для буферов данных запросов IOCTL. Допустимые значения: WdfDeviceIoBuffered и WdfDeviceIoDirect.

DirectTransferThreshold

Этот элемент не применяется к KMDF.

UMDF Необязательное значение, указывающее наименьший размер буфера (в байтах), для которого платформа будет использовать прямой ввод-вывод для устройства. Например, задайте для DirectTransferThreshold значение 12288, чтобы указать, что платформа должна использовать буферный ввод-вывод для всех буферов, размер которых меньше 12 килобайт, а прямой ввод-вывод — для буферов, размер которых превышает 12 килобайт. Как правило, это значение не требуется, так как платформа использует параметры, обеспечивающие наилучшую производительность.

Комментарии

Структура WDF_IO_TYPE_CONFIG используется в качестве входных данных для метода WdfDeviceInitSetIoTypeEx .

Чтобы инициализировать структуру WDF_IO_TYPE_CONFIG , драйвер должен вызвать WDF_IO_TYPE_CONFIG_INIT.

Если вы пишете драйвер с помощью UMDF версии 2.0 или более поздней, дополнительные сведения об указании предпочтительных методов доступа к буферу см. в статье Управление методами доступа к буферу в драйверах UMDF .

Если вы пишете драйвер с помощью UMDF версии 1. x, драйвер вызывает IWDFDeviceInitialize2::SetIoTypePreference , чтобы указать предпочтительные методы доступа к буферу.

Требования

Требование Значение
Минимальная версия KMDF 1.13
Минимальная версия UMDF 2,0
Верхняя часть wdfdevice.h (включая Wdf.h)

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

WDF_DEVICE_IO_TYPE

WDF_IO_TYPE_CONFIG_INIT

WdfDeviceInitSetIoTypeEx