PsSetCreateThreadNotifyRoutine, fonction (ntddk.h)

Article
02/26/2024

La routine PsSetCreateThreadNotifyRoutine inscrit un rappel fourni par le pilote qui est ensuite notifié lors de la création d’un nouveau thread et de la suppression d’un tel thread.

Syntaxe

NTSTATUS PsSetCreateThreadNotifyRoutine(
  [in] PCREATE_THREAD_NOTIFY_ROUTINE NotifyRoutine
);

Paramètres

[in] NotifyRoutine

Pointeur vers l’implémentation de PCREATE_THREAD_NOTIFY_ROUTINE routine par le pilote.

Valeur retournée

PsSetCreateThreadNotifyRoutine retourne STATUS_SUCCESS ou renvoie STATUS_INSUFFICIENT_RESOURCES si l’inscription du rappel a échoué.

Remarques

Les pilotes de niveau supérieur peuvent appeler PsSetCreateThreadNotifyRoutine pour configurer leurs routines de notification de création de threads, déclarées comme suit :

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

Par exemple, un pilote IFS ou un pilote de profilage système de niveau supérieur peut inscrire un tel rappel de création de threads pour suivre la création et la suppression de threads à l’échelle du système par rapport à l’état interne du pilote.

Un pilote doit supprimer les rappels qu’il enregistre avant de se décharger. Vous pouvez supprimer le rappel en appelant la routine PsRemoveCreateThreadNotifyRoutine .

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ntddk.h (inclure Ntddk.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport),IrqlPsPassive(wdm), PowerIrpDDis(wdm)