Функция 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) |