Função RtlRaiseCustomSystemEventTrigger (ntddk.h)
Permite que os serviços NT e os drivers de modo kernel e de modo de usuário gerem 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 ele, 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.
Retornar valor
Essa função retornará STATUS_SUCCESS se o gatilho personalizado tiver sido gerado. Caso contrário, um valor NTSTATUS apropriado será retornado.
| Código do erro | Descrição |
|---|---|
| STATUS_UNSUCCESSFUL | Outro gatilho personalizado ativo sendo acionado. |
| STATUS_INSTANCE_NOT_AVAILABLE | Nenhum assinante está presente. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1803 |
| Cabeçalho | ntddk.h |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
Confira também
_CUSTOM_SYSTEM_EVENT_TRIGGER_CONFIGCUSTOM_SYSTEM_EVENT_TRIGGER_INIT