Compartir a través de


Función RtlRaiseCustomSystemEventTrigger (ntddk.h)

Permite que los servicios NT y los controladores en modo kernel y en modo de usuario generen un desencadenador personalizado para un dispositivo. Un desencadenador personalizado, propiedad del desarrollador del controlador, notifica al agente de eventos del sistema que inicie una tarea en segundo plano asociada con él, que se identifica mediante un identificador de desencadenador personalizado.

Sintaxis

NTSTATUS RtlRaiseCustomSystemEventTrigger(
  [_In_] PCUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG TriggerConfig
);

Parámetros

[_In_] TriggerConfig

Puntero a una estructura de _CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG que contiene el identificador del desencadenador. Llame a CUSTOM_SYSTEM_EVENT_TRIGGER_INIT para inicializar la estructura antes de llamar a la función.

Valor devuelto

Esta función devuelve STATUS_SUCCESS si se generó el desencadenador personalizado. De lo contrario, se devuelve un valor NTSTATUS adecuado.

Código de error Descripción
STATUS_UNSUCCESSFUL Otro desencadenador personalizado activo que se está generando.
STATUS_INSTANCE_NOT_AVAILABLE No hay suscriptores presentes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10, versión 1803
encabezado de ntddk.h
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe

Consulte también

_CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIGCUSTOM_SYSTEM_EVENT_TRIGGER_INIT