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 que puso en cola una llamada anterior a la rutina 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 .

Comentarios

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 quitó 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 valor devuelto TRUE deben tratar los valores devueltos de TRUE y FALSE de forma idéntica.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	Cualquier nivel
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport)

Consulte también

KeInitializeDpc

KeInsertQueueDpc