Função PsSetCreateThreadNotifyRoutine (ntddk.h)

Artigo
02/07/2025

A rotina de PsSetCreateThreadNotifyRoutine registra um retorno de chamada fornecido pelo driver que é posteriormente notificado quando um novo thread é criado e quando esse thread é excluído.

Sintaxe

NTSTATUS PsSetCreateThreadNotifyRoutine(
  [in] PCREATE_THREAD_NOTIFY_ROUTINE NotifyRoutine
);

Parâmetros

[in] NotifyRoutine

Um ponteiro para a implementação do driver de rotina de PCREATE_THREAD_NOTIFY_ROUTINE.

Valor de retorno

PsSetCreateThreadNotifyRoutine retorna STATUS_SUCCESS ou retorna STATUS_INSUFFICIENT_RESOURCES se falhou no registro de retorno de chamada.

Observações

Os drivers de nível mais alto podem chamar PsSetCreateThreadNotifyRoutine para configurar suas rotinas de notificação de criação de thread, declaradas da seguinte maneira:

VOID
(*PCREATE_THREAD_NOTIFY_ROUTINE) (
    IN HANDLE  ProcessId,
    IN HANDLE  ThreadId,
    IN BOOLEAN  Create
    );

Por exemplo, um driver ifs ou de perfil de sistema de nível mais alto pode registrar esse retorno de chamada de criação de thread para acompanhar a criação e a exclusão de threads em todo o sistema em relação ao estado interno do driver.

Um driver deve remover os retornos de chamada registrados antes de descarregar. Você pode remover o retorno de chamada chamando a rotina de PsRemoveCreateThreadNotifyRoutine.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ntddk.h (inclua Ntddk.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)