RtlRaiseCustomSystemEventTrigger-Funktion (ntddk.h)

Ermöglicht NT-Diensten und Kernelmodus- und Benutzermodustreibern, einen benutzerdefinierten Trigger für ein Gerät auszulösen. Ein benutzerdefinierter Trigger, der dem Treiberentwickler gehört, benachrichtigt den Systemereignisbroker, damit eine zugeordnete Hintergrundaufgabe zu starten, die durch einen benutzerdefinierten Triggerbezeichner identifiziert wird.

Syntax

NTSTATUS RtlRaiseCustomSystemEventTrigger(
  [_In_] PCUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG TriggerConfig
);

Parameter

[_In_] TriggerConfig

Ein Zeiger auf eine _CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG-Struktur , die den Triggerbezeichner enthält. Rufen Sie CUSTOM_SYSTEM_EVENT_TRIGGER_INIT auf, um die Struktur vor dem Aufrufen der Funktion zu initialisieren.

Rückgabewert

Diese Funktion gibt STATUS_SUCCESS zurück, wenn der benutzerdefinierte Trigger ausgelöst wurde. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben.

Fehlercode	BESCHREIBUNG
STATUS_UNSUCCESSFUL	Ein weiterer aktiver benutzerdefinierter Trigger wird ausgelöst.
STATUS_INSTANCE_NOT_AVAILABLE	Es sind keine Abonnenten vorhanden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	ntddk.h
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe

Weitere Informationen

_CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIGCUSTOM_SYSTEM_EVENT_TRIGGER_INIT