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

Статья
08/08/2023

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

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

Синтаксис

void WdfDeviceInitSetIoType(
  [in] PWDFDEVICE_INIT    DeviceInit,
  [in] WDF_DEVICE_IO_TYPE IoType
);

Параметры

[in] DeviceInit

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

[in] IoType

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

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

None

Remarks

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

UMDF При преобразовании драйвера KMDF, который вызывает WdfDeviceInitSetIoType , в UMDF версии 2.0 или более поздней, преобразованный драйвер может продолжать вызывать WdfDeviceInitSetIoType без проблем. Однако если вы пишете совершенно новый драйвер с использованием UMDF версии 2.0 или более поздней, следует использовать WdfDeviceInitSetIoTypeEx.

Если драйвер вызывает WdfDeviceInitSetIoType, он должен сделать это перед вызовом WdfDeviceCreate. Дополнительные сведения о вызове WdfDeviceCreate см. в разделе Создание объекта устройства платформы.

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

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

Примеры

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

WdfDeviceInitSetIoType(
                       DeviceInit,
                       WdfDeviceIoDirect
                       );

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfdevice.h (включая Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

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

IWDFDeviceInitialize2::SetIoTypePreference

WDF_DEVICE_IO_TYPE

WdfDeviceInitSetIoTypeEx

Поделиться через