Fungsi PsSetCreateThreadNotifyRoutineEx (ntddk.h)

Artikel
08/07/2023

Rutinitas PsSetCreateThreadNotifyRoutineEx mendaftarkan panggilan balik yang disediakan driver yang kemudian diberi tahu ketika utas baru dibuat dan ketika utas tersebut dihapus.

Sintaks

NTSTATUS PsSetCreateThreadNotifyRoutineEx(
  [in] PSCREATETHREADNOTIFYTYPE NotifyType,
  [in] PVOID                    NotifyInformation
);

Parameter

[in] NotifyType

Nilai PSCREATETHREADNOTIFYTYPE yang menunjukkan jenis pemberitahuan utas.

[in] NotifyInformation

Menyediakan alamat informasi pemberitahuan untuk jenis pemberitahuan utas yang ditentukan. Jika NotifyType adalah PsCreateThreadNotifyNonSystem atau PsCreateThreadNotifySubsystems maka NotifyInformation harus menjadi penunjuk ke implementasi driver PCREATE_THREAD_NOTIFY_ROUTINE.

Nilai kembali

PsSetCreateThreadNotifyRoutineEx mengembalikan STATUS_SUCCESS atau mengembalikan STATUS_INSUFFICIENT_RESOURCES jika gagal dalam pendaftaran panggilan balik.

Keterangan

Driver tingkat tertinggi dapat memanggil PsSetCreateThreadNotifyRoutineEx untuk menyiapkan rutinitas pemberitahuan pembuatan utas mereka.

Misalnya, IFS atau driver pembuatan profil sistem tingkat tertinggi mungkin mendaftarkan panggilan balik pembuatan utas tersebut untuk melacak pembuatan dan penghapusan utas di seluruh sistem terhadap status internal driver.

Jika NotifyType adalah PsCreateThreadNotifyNonSystem, rutinitas PsSetCreateThreadNotifyRoutineEx berbeda dari PsSetCreateThreadNotifyRoutine dalam konteks di mana panggilan balik dijalankan. Dengan PsSetCreateThreadNotifyRoutine, panggilan balik dijalankan pada utas pembuat. Dengan PsSetCreateThreadNotifyRoutineEx, panggilan balik dijalankan pada utas yang baru dibuat.

Driver harus menghapus fungsi panggilan balik apa pun yang didaftarkannya sebelum dibongkar. Anda dapat menghapus panggilan balik dengan memanggil rutinitas PsRemoveCreateThreadNotifyRoutine .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 10.
Target Platform	Universal
Header	ntddk.h (termasuk Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL