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)

Consulte también

EvtDpcFunc

WdfDpcCreate