Compartilhar via


Função KeRemoveQueueDpc (wdm.h)

A rotina de 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 de KeInsertQueueDpc.

Valor de retorno

KeRemoveQueueDpc retornará verdadeiro 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.

Observações

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 VERDADEIRO 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 que KeRemoveQueueDpc retorne VERDADEIRO. Nestas versões anteriores do Windows, drivers que não podem tolerar ambiguidade no valor retornado TRUE VERDADEIRO devem tratar valores retornados de VERDADEIRO e FALSE idênticos.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows 2000.
da Plataforma de Destino Universal
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL Qualquer nível
regras de conformidade de DDI HwStorPortProhibitedDIs(storport)

Consulte também

KeInitializeDpc

KeInsertQueueDpc