KeInsertQueueDpc-Funktion (wdm.h)

Artikel
02/27/2024

Die KeInsertQueueDpc-Routine stellt einen DPC für die Ausführung in die Warteschlange.

Syntax

BOOLEAN KeInsertQueueDpc(
  [in, out]      PRKDPC                 Dpc,
  [in, optional] PVOID                  SystemArgument1,
  [in, optional] __drv_aliasesMem PVOID SystemArgument2
);

Parameter

[in, out] Dpc

Zeiger auf die KDPC-Struktur für das DPC-Objekt. Diese Struktur muss entweder von KeInitializeDpc oder KeInitializeThreadedDpc initialisiert worden sein.

[in, optional] SystemArgument1

Gibt vom Treiber bestimmte Kontextdaten an. Dieser Wert wird als SystemArgument1-Parameter an die CustomDpc - oder CustomThreadedDpc-Routine des DPC-Objekts übergeben.

[in, optional] SystemArgument2

Gibt vom Treiber bestimmte Kontextdaten an. Dieser Wert wird als SystemArgument2-Parameter an die CustomDpc - oder CustomThreadedDpc-Routine des DPC-Objekts übergeben.

Rückgabewert

Wenn sich das angegebene DPC-Objekt derzeit nicht in einer DPC-Warteschlange befindet, stellt KeInsertQueueDpc den DPC in die Warteschlange und gibt TRUE zurück.

Hinweise

Wenn das angegebene DPC-Objekt bereits in die Warteschlange gestellt wurde, wird kein Vorgang ausgeführt, außer false zurückzugeben. Andernfalls wird das DPC-Objekt in eine DPC-Warteschlange eingefügt. Weitere Informationen zu DPC-Warteschlangen finden Sie unter Organisation von DPC-Warteschlangen.

Beachten Sie, dass ein bestimmtes DPC-Objekt und die funktion, die es darstellt, jeweils nur einmal zu einem bestimmten Zeitpunkt für die Ausführung in die Warteschlange gestellt werden können.

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), MarkingQueuedIrps(wdm)

Weitere Informationen

Freigeben über