Funzione KeRemoveQueueDpc (wdm.h)

  • Articolo

La routine KeRemoveQueueDpc rimuove l'oggetto DPC specificato dalla coda DPC di sistema.

Sintassi

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

Parametri

[in, out] Dpc

Puntatore a un oggetto DPC inizializzato accodato da una chiamata precedente alla routine KeInsertQueueDpc .

Valore restituito

KeRemoveQueueDpc restituisce TRUE se l'oggetto DPC si trova nella coda DPC. Se l'oggetto DPC specificato non è attualmente presente nella coda DPC, non viene eseguita alcuna operazione e viene restituito FALSE .

Commenti

Se l'oggetto DPC specificato è attualmente in coda, viene rimosso dalla coda, annullando una chiamata alla routine DPC associata.

A partire da Windows Vista con Service Pack 1 (SP1) e Windows Server 2008, un valore restituito true indica sempre che KeRemoveQueueDpc ha rimosso correttamente l'oggetto DPC dalla coda DPC prima dell'avvio della routine DPC. Nelle versioni precedenti di Windows, la routine DPC può essere eseguita occasionalmente anche se KeRemoveQueueDpc restituisce TRUE. In queste versioni precedenti di Windows, i driver che non possono tollerare ambiguità nel valore restituito TRUE devono trattare i valori restituiti di TRUE e FALSE in modo identico.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 2000.
Piattaforma di destinazione Universale
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Qualsiasi livello
Regole di conformità DDI HwStorPortProhibitedDDIs(storport)

Vedi anche

KeInitializeDpc

KeInsertQueueDpc