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


Функция WdfDpcEnqueue (wdfdpc.h)

[Применяется только к KMDF]

Метод WdfDpcEnqueue планирует выполнение функции обратного вызова EvtDpcFunc объекта DPC.

Синтаксис

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

Параметры

[in] Dpc

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

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

WdfDpcEnqueue возвращает значение TRUE , если он успешно добавляет указанный объект DPC в очередь DPC системы. В противном случае метод возвращает значение FALSE.

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

Комментарии

Метод WdfDpcEnqueue добавляет указанный объект DPC в очередь DPC системы, если он еще не находится в очереди. (Если объект DPC уже был в очереди, метод возвращает значение FALSE.) Если система не выполняет задачи с более высоким приоритетом, она удаляет объект DPC из очереди и вызывает функцию обратного вызова EvtDpcFunc объекта.

После выполнения функции обратного вызова последующий вызов WdfDpcEnqueue добавит объект DPC обратно в очередь DPC.

Дополнительные сведения об использовании объектов DPC см. в разделе Обслуживание прерывания.

Примеры

В следующем примере кода запланировано выполнение функции обратного вызова, связанной с объектом DPC. В примере используется возвращаемое значение метода WdfDpcEnqueue в качестве возвращаемого значения содержащей функции. В примере кода WdfDpcCreate показано, как был создан объект DPC.

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfdpc.h (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL Любой уровень
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

EvtDpcFunc

WdfDpcCreate