Функция WdfIoQueueStart (wdfio.h)

Статья
02/29/2024

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

Метод WdfIoQueueStart позволяет очереди ввода-вывода начать получать и доставлять новые запросы ввода-вывода.

Синтаксис

void WdfIoQueueStart(
  [in] WDFQUEUE Queue
);

Параметры

[in] Queue

Дескриптор объекта очереди платформы.

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

None

Remarks

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

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

Дополнительные сведения о методе WdfIoQueueStart см. в разделе Управление очередями ввода-вывода.

Примеры

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

WdfIoQueuePurge(
                ReadQueue, 
                WDF_NO_EVENT_CALLBACK, 
                WDF_NO_CONTEXT
                );
WdfIoQueueStart(ReadQueue);

Требования

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

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

WdfIoQueuePurge

WdfIoQueueStop

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