Compartilhar via


Função RtlRaiseCustomSystemEventTrigger (ntddk.h)

Permite que os serviços NT e drivers de modo kernel e modo de usuário acionem um gatilho personalizado para um dispositivo. Um gatilho personalizado, de propriedade do desenvolvedor do driver, notifica o agente de eventos do sistema para iniciar uma tarefa em segundo plano associada a ela, que é identificada por um identificador de gatilho personalizado.

Sintaxe

NTSTATUS RtlRaiseCustomSystemEventTrigger(
  [_In_] PCUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG TriggerConfig
);

Parâmetros

[_In_] TriggerConfig

Um ponteiro para uma estrutura _CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIG que contém o identificador de gatilho. Chame CUSTOM_SYSTEM_EVENT_TRIGGER_INIT para inicializar a estrutura antes de chamar a função.

Valor de retorno

Essa função retornará STATUS_SUCCESS se o gatilho personalizado tiver sido acionado. Caso contrário, um valor NTSTATUS apropriado é retornado.

Código de erro Descrição
STATUS_UNSUCCESSFUL Outro gatilho personalizado ativo sendo acionado.
STATUS_INSTANCE_NOT_AVAILABLE Nenhum assinante está presente.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10, versão 1803
cabeçalho ntddk.h
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe

Consulte também

_CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIGCUSTOM_SYSTEM_EVENT_TRIGGER_INIT