Función WdfDpcWdmGetDpc (wdfdpc.h)

[Solo se aplica a KMDF]

El método WdfDpcWdmGetDpc devuelve un puntero a la estructura KDPC asociada a un objeto DPC de marco especificado.

Sintaxis

PKDPC WdfDpcWdmGetDpc(
  [in] WDFDPC Dpc
);

Parámetros

[in] Dpc

Identificador de un objeto DPC de marco.

Valor devuelto

WdfDpcWdmGetDpc devuelve un puntero a la estructura KDPC asociada al objeto DPC de marco especificado.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

El marco crea una estructura KDPC cuando un controlador basado en marcos llama a WdfDpcCreate para crear un objeto DPC.

Un controlador puede llamar a WdfDpcWdmGetDpc desde su función de devolución de llamada EvtDpcFunc .

El puntero que WdfDpcWdmGetDpc devuelve es válido hasta que se elimina el objeto DPC del marco. Si el controlador proporciona una función EvtCleanupCallback para el objeto DPC del marco, el puntero es válido hasta que se devuelve la función de devolución de llamada.

Ejemplos

En el ejemplo de código siguiente se devuelve un puntero a la estructura KDPC asociada a un objeto DPC especificado. En el ejemplo de código WdfDpcCreate se muestra cómo se creó el objeto DPC especificado.

PKDPC pWdmDpc;

pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfdpc.h (incluya Wdf.h)
Library	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL	Cualquier nivel
Reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

EvtDpcFunc

KDPC

WDF_DPC_CONFIG

WdfDpcCreate