KeRemoveQueueDpc-Funktion (wdm.h)
Die KeRemoveQueueDpc-Routine entfernt das angegebene DPC-Objekt aus der System-DPC-Warteschlange.
Syntax
BOOLEAN KeRemoveQueueDpc(
[in, out] PRKDPC Dpc
);
Parameter
[in, out] Dpc
Ein Zeiger auf ein initialisiertes DPC-Objekt, das durch einen vorherigen Aufruf der KeInsertQueueDpc-Routine in die Warteschlange gestellt wurde.
Rückgabewert
KeRemoveQueueDpc gibt TRUE zurück, wenn sich das DPC-Objekt in der DPC-Warteschlange befindet. Wenn sich das angegebene DPC-Objekt derzeit nicht in der DPC-Warteschlange befindet, wird kein Vorgang ausgeführt, und FALSE wird zurückgegeben.
Hinweise
Wenn sich das angegebene DPC-Objekt derzeit in einer Warteschlange befindet, wird es aus der Warteschlange entfernt und ein Aufruf der zugeordneten DPC-Routine abgebrochen.
Ab Windows Vista mit Service Pack 1 (SP1) und Windows Server 2008 bedeutet ein Rückgabewert von TRUE immer, dass KeRemoveQueueDpc das DPC-Objekt erfolgreich aus der DPC-Warteschlange entfernt hat, bevor die DPC-Routine ausgeführt wurde. In früheren Versionen von Windows kann die DPC-Routine gelegentlich ausgeführt werden, auch wenn KeRemoveQueueDpcTRUE zurückgibt. In diesen früheren Versionen von Windows sollten Treiber, die Mehrdeutigkeiten im TRUE-Rückgabewert nicht tolerieren können, Rückgabewerte von TRUE und FALSE identisch behandeln.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
Zielplattform | Universell |
Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
Bibliothek | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | Beliebige Ebene |
DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport) |