функция WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE (wdfio.h)

Статья
02/27/2024

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

Функция WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE инициализирует структуру WDF_IO_QUEUE_CONFIG драйвера.

Синтаксис

void WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

Параметры

[out] Config

Указатель на структуру WDF_IO_QUEUE_CONFIG драйвера.

[in] DispatchType

Перечислитель WDF_IO_QUEUE_DISPATCH_TYPE , идентифицирующий тип отправки запроса для очереди.

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

None

Remarks

Драйверы должны вызывать WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE при создании очереди ввода-вывода, управляемой питанием, которая является очередью устройства по умолчанию. Функция WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE обнуляет указанную структуру WDF_IO_QUEUE_CONFIG и задает ее член Size . Он также задает для элемента PowerManagedзначение WdfUseDefault, задает для элемента DefaultQueue значение TRUE и сохраняет указанный тип диспетчеризации в элементе DispatchType .

Начиная с KMDF версии 1.9, если параметр DispatchType имеет значение WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE задает для элемента NumberOfPresentedRequests структуры значение -1. Это значение указывает, что платформа может доставлять драйверу неограниченное количество запросов ввода-вывода.

Пример кода, в котором используется WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE, см. в разделе WdfIoQueueCreate.

Требования

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

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

WDF_IO_QUEUE_CONFIG

WDF_IO_QUEUE_CONFIG_INIT

WDF_IO_QUEUE_DISPATCH_TYPE

WdfIoQueueCreate

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