KeInsertQueueDpc-Funktion (wdm.h)
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) |