Función WdfDpcCancel (wdfdpc.h)

[Solo se aplica a KMDF]

El método WdfDpcCancel intenta cancelar la ejecución de la función de devolución de llamada programada de un objeto DPC EvtDpcFunc.

Sintaxis

BOOLEAN WdfDpcCancel(
  [in] WDFDPC  Dpc,
  [in] BOOLEAN Wait
);

Parámetros

[in] Dpc

Identificador de un objeto DPC de marco.

[in] Wait

Valor booleano que, si TRUE, indica que el método WdfDpcCancel no devolverá hasta que la función de devolución de llamada del objeto DPC EvtDpcFunc se cancele o termine de ejecutarse. Si FALSE, el método WdfDpcCancel devuelve inmediatamente.

Valor devuelto

WdfDpcCancel devuelve TRUE si la función de devolución de llamada evtDpcFun c del objeto DPC especificada estaba en la cola DPC del sistema. El método devuelve FALSE si la función de devolución de llamada no estaba en la cola DPC, ya sea porque la función de devolución de llamada se estaba ejecutando o porque había terminado de ejecutarse.

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

Observaciones

Si el objeto DPC especificado EvtDpcFunc función de devolución de llamada está en la cola DPC del sistema, se quita de la cola. Si la función EvtDpcFunc no está en la cola, se está ejecutando o ha terminado de ejecutarse.

Si el parámetro wait es TRUE, se debe llamar a WdfDpcCancel en IRQL = PASSIVE_LEVEL. Si el parámetro wait es FALSE, se puede llamar a WdfDpcCancel en cualquier IRQL.

Ejemplos

En el ejemplo de código siguiente se cancela la ejecución de la función de devolución de llamada asociada al objeto DPC que el ejemplo de código del WdfDpcCreate tema creado.

WdfDpcCancel(
             PDevExt->CompleteWriteDpc,
             TRUE
             );

Requisitos

Consulte también

EvtDpcFunc