Función WdfDpcEnqueue (wdfdpc.h)
[Solo se aplica a KMDF]
El método WdfDpcEnqueue programa la ejecución de la función de devolución de llamada EvtDpcFunc de un objeto DPC.
Sintaxis
BOOLEAN WdfDpcEnqueue(
[in] WDFDPC Dpc
);
Parámetros
[in] Dpc
Identificador de un objeto DPC de marco.
Valor devuelto
WdfDpcEnqueue devuelve TRUE si agrega correctamente el objeto DPC especificado a la cola DPC del sistema. De lo contrario, el método devuelve FALSE.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Comentarios
El método WdfDpcEnqueue agrega el objeto DPC especificado a la cola DPC del sistema, si aún no está en la cola. (Si el objeto DPC ya estaba en la cola, el método devuelve FALSE). Cuando el sistema no ejecuta tareas de mayor prioridad, quita el objeto DPC de la cola y llama a la función de devolución de llamada EvtDpcFunc del objeto.
Una vez ejecutada la función de devolución de llamada, una llamada posterior a WdfDpcEnqueue volverá a agregar el objeto DPC a la cola DPC.
Para obtener más información sobre el uso de objetos DPC, vea Mantenimiento de una interrupción.
Ejemplos
En el ejemplo de código siguiente se programa la ejecución de la función de devolución de llamada asociada a un objeto DPC. En el ejemplo se usa el valor devuelto del método WdfDpcEnqueue como valor devuelto de la función contenedora. En el ejemplo de código WdfDpcCreate se muestra cómo se creó el objeto DPC.
return WdfDpcEnqueue(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) |