Função KeRemoveQueueDpc (wdm.h)
A rotina KeRemoveQueueDpc remove o objeto DPC especificado da fila DPC do sistema.
Sintaxe
BOOLEAN KeRemoveQueueDpc(
[in, out] PRKDPC Dpc
);
Parâmetros
[in, out] Dpc
Um ponteiro para um objeto DPC inicializado que foi enfileirado por uma chamada anterior para a rotina KeInsertQueueDpc .
Retornar valor
KeRemoveQueueDpc retornará TRUE se o objeto DPC estiver na fila DPC. Se o objeto DPC especificado não estiver atualmente na fila DPC, nenhuma operação será executada e FALSE será retornado.
Comentários
Se o objeto DPC especificado estiver na fila no momento, ele será removido da fila, cancelando uma chamada para a rotina de DPC associada.
A partir do Windows Vista com o Service Pack 1 (SP1) e o Windows Server 2008, um valor retornado de TRUE sempre significa que KeRemoveQueueDpc removeu com êxito o objeto DPC da fila DPC antes da rotina DPC começar a ser executada. Em versões anteriores do Windows, a rotina de DPC pode ocasionalmente ser executada mesmo se KeRemoveQueueDpc retornar TRUE. Nessas versões anteriores do Windows, os drivers que não toleram ambiguidade no valor retornado TRUE devem tratar os valores retornados de TRUE e FALSE de forma idêntica.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualquer nível |
| Regras de conformidade de DDI | HwStorPortProhibitedDDIs(storport) |