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) |