Condividi tramite


Funzione PsSetCreateThreadNotifyRoutine (ntddk.h)

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)

Vedi anche

PsGetCurrentProcessId

PsGetCurrentThreadId

PsIsSystemThread

PsRemoveCreateThreadNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetLoadImageNotifyRoutine