Função PsSetCreateThreadNotifyRoutine (ntddk.h)

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)

Confira também

PsGetCurrentProcessId

PsGetCurrentThreadId

PsIsSystemThread

PsRemoveCreateThreadNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetLoadImageNotifyRoutine