Funzione KeRemoveQueueDpc (wdm.h)
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) |