Partager via


PsSetCreateThreadNotifyRoutine, fonction (ntddk.h)

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)

Voir aussi

PsGetCurrentProcessId

PsGetCurrentThreadId

PsIsSystemThread

PsRemoveCreateThreadNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetLoadImageNotifyRoutine