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

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

Метод WdfDpcWdmGetDpc возвращает указатель на структуру KDPC, связанную с указанным объектом DPC платформы.

Синтаксис

PKDPC WdfDpcWdmGetDpc(
  [in] WDFDPC Dpc
);

Параметры

[in] Dpc

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

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

WdfDpcWdmGetDpc возвращает указатель на структуру KDPC, связанную с указанным объектом DPC платформы.

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

Замечания

Платформа создает структуру KDPC, когда драйвер на основе платформы вызывает WdfDpcCreate для создания объекта DPC.

Драйвер может вызывать WdfDpcWdmGetDpc из функции обратного вызова EvtDpcF unc.

Указатель, возвращаемый WdfDpcWdmGetDpc, действителен до удаления объекта DPC платформы. Если драйвер предоставляет функцию EvtCleanupCallback для объекта DPC платформы, указатель действителен до тех пор, пока функция обратного вызова не возвращается.

Примеры

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

PKDPC pWdmDpc;

pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);

Требования

См. также

EvtDpcFunc

KDPC

WDF_DPC_CONFIG

WdfDpcCreate