Funzione PsSetCreateThreadNotifyRoutine (ntddk.h)

Articolo
02/07/2025

La routine PsSetCreateThreadNotifyRoutine registra un callback fornito dal driver che viene successivamente informato quando viene creato un nuovo thread e quando tale thread viene eliminato.

Sintassi

NTSTATUS PsSetCreateThreadNotifyRoutine(
  [in] PCREATE_THREAD_NOTIFY_ROUTINE NotifyRoutine
);

Parametri

[in] NotifyRoutine

Puntatore all'implementazione del driver di PCREATE_THREAD_NOTIFY_ROUTINE routine.

Valore restituito

PsSetCreateThreadNotifyRoutine restituisce STATUS_SUCCESS oppure restituisce STATUS_INSUFFICIENT_RESOURCES se non è riuscita la registrazione del callback.

Osservazioni

I driver di livello più elevato possono chiamare PsSetCreateThreadNotifyRoutine per configurare le routine di notifica di creazione del thread, dichiarate come segue:

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

Ad esempio, un driver IFS o di profilatura di sistema di livello più alto potrebbe registrare un callback di creazione di thread per tenere traccia della creazione e dell'eliminazione a livello di sistema dei thread rispetto allo stato interno del driver.

Un driver deve rimuovere tutti i callback registrati prima di scaricare. È possibile rimuovere il callback chiamando la routine PsRemoveCreateThreadNotifyRoutine.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	ntddk.h (include Ntddk.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regole di conformità DDI	HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)