Função PsSetCreateThreadNotifyRoutine (ntddk.h)

Artigo
02/26/2024

A rotina PsSetCreateThreadNotifyRoutine registra um retorno de chamada fornecido pelo driver que é notificado posteriormente 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 .

Retornar valor

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

Comentários

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

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

Por exemplo, um ifs ou driver de criação 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 exclusão de threads em todo o sistema em relação ao estado interno do driver.

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

Requisitos

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