RtlRaiseCustomSystemEventTrigger function

Allows NT services and kernel-mode and user-mode drivers to raise a custom trigger for a device. A custom trigger, owned by the driver developer, notifies system event broker to start an associated background task with it, which is identified by a custom trigger identifier.

Syntax

NTSTATUS RtlRaiseCustomSystemEventTrigger(
  PCUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG TriggerConfig
);

Parameters

TriggerConfig

[In] A pointer to a _CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG structure that contains hte trigger identfier. Call CUSTOM_SYSTEM_EVENT_TRIGGER_INIT to initialize the structure before calling the function.

Return Value

This function returns STATUS_SUCCESS if the custom trigger was raised. Otherwise, an appropriate NTSTATUS Value is returned.

Error code Description
STATUS_UNSUCCESSFUL Another active custom trigger being raised.
STATUS_INSTANCE_NOT_AVAILABLE No subscribers are present.

Requirements

   
Minimum supported client Windows 10, version 1803
Header ntddk.h
Library NtosKrnl.lib
DLL NtosKrnl.exe

See Also

_CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG CUSTOM_SYSTEM_EVENT_TRIGGER_INIT