Compartir a través de


Función KeRemoveQueueDpc (wdm.h)

La rutina KeRemoveQueueDpc quita el objeto DPC especificado de la cola DPC del sistema.

Sintaxis

BOOLEAN KeRemoveQueueDpc(
  [in, out] PRKDPC Dpc
);

Parámetros

[in, out] Dpc

Puntero a un objeto DPC inicializado en cola por una llamada anterior a la rutina de KeInsertQueueDpc.

Valor devuelto

keRemoveQueueDpc devuelve TRUE si el objeto DPC está en la cola DPC. Si el objeto DPC especificado no está actualmente en la cola DPC, no se realiza ninguna operación y se devuelve FALSE.

Observaciones

Si el objeto DPC especificado está actualmente en cola, se quita de la cola, cancelando una llamada a la rutina DPC asociada.

A partir de Windows Vista con Service Pack 1 (SP1) y Windows Server 2008, un valor devuelto de TRUE siempre significa que KeRemoveQueueDpc quitar correctamente el objeto DPC de la cola DPC antes de que la rutina DPC empezara a ejecutarse. En versiones anteriores de Windows, la rutina DPC podría ejecutarse ocasionalmente incluso si KeRemoveQueueDpc devuelve TRUE. En estas versiones anteriores de Windows, los controladores que no pueden tolerar ambigüedad en el VERDADERO valor devuelto deben tratar los valores devueltos de TRUE y FALSE idénticamente.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows 2000.
de la plataforma de destino de Universal
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL Cualquier nivel
reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport)

Consulte también

KeInitializeDpc

KeInsertQueueDpc