KeInsertQueueDpc-Funktion (wdm.h)
Die KeInsertQueueDpc Routinewarteschlangen für die Ausführung ein DPC.
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 KeInitializeThreadedDpcinitialisiert worden sein.
[in, optional] SystemArgument1
Gibt treiberbestimmte Kontextdaten an. Dieser Wert wird als SystemArgument1 Parameter an die CustomDpc oder CustomThreadedDpc Routine des DPC-Objekts übergeben.
[in, optional] SystemArgument2
Gibt treiberbestimmte 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, KeInsertQueueDpc den DPC in die Warteschlange ein und gibt TRUEzurück.
Bemerkungen
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 darin dargestellte Funktion jeweils nur einmal für die Ausführung in die Warteschlange gestellt werden können.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Beliebige Ebene |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), MarkingQueuedIrps(wdm) |