функция обратного вызова EVT_WDF_TIMER (wdftimer.h)

Статья
03/05/2024

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

Функция обратного вызова события EvtTimerFunc вызывается по истечении указанного периода времени.

Синтаксис

EVT_WDF_TIMER EvtWdfTimer;

void EvtWdfTimer(
  [in] WDFTIMER Timer
)
{...}

Параметры

[in] Timer

Дескриптор объекта таймера платформы, полученный из предыдущего вызова WdfTimerCreate.

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

None

Remarks

Чтобы зарегистрировать функцию обратного вызова EvtTimerFunc и указать период времени, который должен пройти до вызова этой функции платформой, драйвер должен вызвать WdfTimerCreate.

В версиях KMDF, предшествующих версии 1.9, платформа реализует функции обратного вызова EvtTimerFunc в качестве отложенных вызовов процедур (DPC). Таким образом, по истечении периода времени система добавляет вызов функции обратного вызова EvtTimerFunc в очередь DPC. Система вызывает функцию обратного вызова EvtTimerFunc по адресу IRQL = DISPATCH_LEVEL, когда она достигает передней части очереди и доступен ЦП, работающий на DISPATCH_LEVEL IRQL < .

В KMDF версии 1.9 и более поздних платформа по умолчанию реализует функции обратного вызова EvtTimerFunc в качестве DPC. Кроме того, если драйвер задает для объекта таймера уровень выполнения WdfExecutionLevelPassive, платформа вызывает функцию обратного вызова EvtTimerFunc из рабочего элемента в IRQL = PASSIVE_LEVEL.

Примечание

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

Начиная с версии UMDF 2.0 функции обратного вызова EvtTimerFunc драйвера UMDF всегда выполняются в PASSIVE_LEVEL.

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

Требования

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

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

WdfTimerCreate

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