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


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

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

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

Синтаксис

void WDF_IO_QUEUE_CONFIG_INIT(
  [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 при создании очереди ввода-вывода, управляемой питанием, которая не является очередью устройства по умолчанию. Функция WDF_IO_QUEUE_CONFIG_INIT обнуляет указанную структуру WDF_IO_QUEUE_CONFIG и задает ее член Size . Он также задает для элемента PowerManagedзначение WdfUseDefault и сохраняет указанный тип диспетчеризации в элементе DispatchType .

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

Примеры

В следующем примере кода инициализируется структура WDF_IO_QUEUE_CONFIG , а затем вызывается WdfIoQueueCreate.

WDF_IO_QUEUE_CONFIG  queueConfig;
NTSTATUS  status = STATUS_SUCCESS;
WDFQUEUE  readQueue;

WDF_IO_QUEUE_CONFIG_INIT(
                         &queueConfig,
                         WdfIoQueueDispatchManual
                         );
status = WdfIoQueueCreate(
                          hDevice,
                          &queueConfig,
                          WDF_NO_OBJECT_ATTRIBUTES,
                          &readQueue
                          );

Требования

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

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

WDF_IO_QUEUE_CONFIG

WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE

WDF_IO_QUEUE_DISPATCH_TYPE

WdfIoQueueCreate