Edit

RtlRaiseCustomSystemEventTrigger function (ntddk.h)

  • Article

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(
  [_In_] PCUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG TriggerConfig
);

Parameters

[_In_] TriggerConfig

A pointer to a _CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG structure that contains the trigger identifier. 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

Requirement Value
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