KeRemoveQueueDpc-Funktion (wdm.h)

  • Artikel

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)

Weitere Informationen

KeInitializeDpc

KeInsertQueueDpc