KeRemoveQueueDpc-Funktion (wdm.h)

Die KeRemoveQueueDpc Routine entfernt das angegebene DPC-Objekt aus der DPC-Systemwarteschlange.

Syntax

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

Parameter

[in, out] Dpc

Ein Zeiger auf ein initialisiertes DPC-Objekt, das von einem vorherigen Aufruf des 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- zurückgegeben wird.

Bemerkungen

Wenn das angegebene DPC-Objekt zurzeit in die Warteschlange eingereiht wird, wird es aus der Warteschlange entfernt, um einen Aufruf an die zugeordnete DPC-Routine abzubrechen.

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 KeRemoveQueueDpcTRUEzurückgibt. In diesen früheren Versionen von Windows sollten Treiber, die keine Mehrdeutigkeit im TRUE- Rückgabewert tolerieren können, Rückgabewerte von TRUE- und FALSE- identisch behandeln.

Anforderungen

Siehe auch

KeInitializeDpc

KeInsertQueueDpc