Функция WdfDeviceInitSetIoTypeEx (wdfdevice.h)

Статья
08/08/2023

[Относится к KMDF и UMDF]

Метод WdfDeviceInitSetIoTypeEx задает метод или предпочтения для доступа драйвера к буферам данных, включенным в запросы на чтение и запись, а также к запросам управления вводом-выводом устройства для указанного устройства.

Синтаксис

void WdfDeviceInitSetIoTypeEx(
  [in] PWDFDEVICE_INIT     DeviceInit,
  [in] PWDF_IO_TYPE_CONFIG IoTypeConfig
);

Параметры

[in] DeviceInit

Указатель на структуру WDFDEVICE_INIT .

[in] IoTypeConfig

Указатель на WDF_IO_TYPE_CONFIG структуру , инициализированную с помощью макроса WDF_IO_TYPE_CONFIG_INIT.

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

None

Remarks

Если вы пишете драйвер с помощью KMDF версии 1.11 или более ранней, необходимо использовать WdfDeviceInitSetIoType.

KMDF Драйвер KMDF вызывает WdfDeviceInitSetIoTypeEx , чтобы задать метод доступа к буферу для запросов на чтение и запись. Для запросов элементов управления вводом-выводом устройств платформа использует тип буфера, закодированный в коде элемента управления ввода-вывода (IOCTL).

UMDF Драйвер UMDF вызывает WdfDeviceInitSetIoTypeEx для регистрации параметров запросов на чтение и запись, а также запросов на управление вводом-выводом устройства. Значения, которые драйвер UMDF предоставляет WdfDeviceInitSetIoTypeEx , являются только предпочтениями и не гарантируются для использования платформой. Драйвер может вызывать WdfDeviceGetDeviceStackIoType , чтобы определить методы доступа к буферу, назначенные UMDF запросам на чтение и запись устройства и запросам управления вводом-выводом. Для запросов управления вводом-выводом метод доступа, который использует платформа, может отличаться от метода доступа, указанного в IOCTL, и метода доступа, запрошенного драйвером.

Если драйвер вызывает WdfDeviceInitSetIoTypeEx, он должен сделать это перед вызовом WdfDeviceCreate.

Если драйвер не вызывает WdfDeviceInitSetIoTypeEx, платформа присваивает методу доступа к буферу драйвера значение WdfDeviceIoBuffered для указанного устройства.

Вызов WdfDeviceInitSetIoTypeEx из драйвера фильтра KMDF не оказывает никакого влияния. Для драйверов фильтров KMDF платформа использует тип ввода-вывода, который указывает следующий драйвер в стеке драйверов.

Однако драйвер фильтра UMDF может зарегистрировать параметры для метода доступа к буферу, вызвав WdfDeviceInitSetIoTypeEx.

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

Дополнительные сведения о методах доступа к буферу см. в разделе Доступ к буферам данных.

Этот метод является эквивалентом UMDF 2.0 IWDFDeviceInitialize2::SetIoTypePreference.

Примеры

В следующем примере кода инициализируется структура WDF_IO_TYPE_CONFIG , задаются параметры буферного доступа драйвера для прямого ввода-вывода, указывается, что при передаче меньше 32 КБ должны использоваться буферизированные операции ввода-вывода, и вызывается WdfDeviceInitSetIoTypeEx.

WDF_IO_TYPE_CONFIG ioConfig;
WDF_IO_TYPE_CONFIG_INIT(&ioConfig);
ioConfig.ReadWriteIoType = WdfDeviceIoDirect;
ioConfig.DeviceControlIoType = WdfDeviceIoDirect;
ioConfig.DirectTransferThreshold = 32;

WdfDeviceInitSetIoTypeEx(DeviceInit, &ioConfig);
}

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1.13
Минимальная версия UMDF	2,0
Верхняя часть	wdfdevice.h (включая Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL