Funzione PsSetCreateThreadNotifyRoutine (ntddk.h)

Articolo
03/05/2024

La routine PsSetCreateThreadNotifyRoutine registra un callback fornito dal driver che riceve successivamente una notifica 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 di callback.

Commenti

I driver di livello più alto 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 alto livello 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 dello scaricamento. È possibile rimuovere il callback chiamando la routine PsRemoveCreateThreadNotifyRoutine .

Requisiti

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)