Функция WdfDpcWdmGetDpc (wdfdpc.h)
[Относится только к KMDF]
Метод WdfDpcWdmGetDpc возвращает указатель на структуру KDPC , связанную с указанным объектом DPC платформы.
Синтаксис
PKDPC WdfDpcWdmGetDpc(
[in] WDFDPC Dpc
);
Параметры
[in] Dpc
Дескриптор объекта DPC платформы.
Возвращаемое значение
WdfDpcWdmGetDpc возвращает указатель на структуру KDPC , связанную с указанным объектом DPC платформы.
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Платформа создает структуру KDPC, когда драйвер на основе платформы вызывает WdfDpcCreate для создания объекта DPC.
Драйвер может вызывать WdfDpcWdmGetDpc из функции обратного вызова EvtDpcFunc .
Указатель, возвращаемый WdfDpcWdmGetDpc , действителен до удаления объекта DPC платформы. Если драйвер предоставляет функцию EvtCleanupCallback для объекта DPC платформы, указатель будет действителен до тех пор, пока функция обратного вызова не вернет значение .
Примеры
В следующем примере кода возвращается указатель на структуру KDPC , связанную с указанным объектом DPC. В примере кода WdfDpcCreate показано, как был создан указанный объект DPC.
PKDPC pWdmDpc;
pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdfdpc.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы). |
| IRQL | Любой уровень |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |