Função KeRemoveQueueDpc (wdm.h)

  • Artigo

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)

Confira também

KeInitializeDpc

KeInsertQueueDpc