Compartir a través de


Función WdfDpcWdmGetDpc (wdfdpc.h)

[Solo se aplica a KMDF]

El método WdfDpcWdpcWdmGetDpc 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 de 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.

Observaciones

El marco crea una estructura KDPC cuando un controlador basado en marco 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 de KDPC asociada a un objeto DPC especificado. El ejemplo de código WdfDpcCreate muestra cómo se creó el objeto DPC especificado.

PKDPC pWdmDpc;

pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);

Requisitos

Requisito Valor
de la plataforma de destino de Universal
versión mínima de KMDF 1.0
encabezado wdfdpc.h (incluya Wdf.h)
Biblioteca 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

WdfDpcCrear