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, 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 zu initialisieren, bevor Sie die Funktion aufrufen.

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, der ausgelöst wird.
STATUS_INSTANCE_NOT_AVAILABLE	Es sind keine Abonnenten vorhanden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1803
Header-	ntddk.h
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe

Siehe auch

_CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIGCUSTOM_SYSTEM_EVENT_TRIGGER_INIT