Fungsi PsSetCreateThreadNotifyRoutine (ntddk.h)

Artikel
02/29/2024

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

Sintaks

NTSTATUS PsSetCreateThreadNotifyRoutine(
  [in] PCREATE_THREAD_NOTIFY_ROUTINE NotifyRoutine
);

Parameter

[in] NotifyRoutine

Penunjuk ke implementasi driver PCREATE_THREAD_NOTIFY_ROUTINE rutin.

Nilai kembali

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

Keterangan

Driver tingkat tertinggi dapat memanggil PsSetCreateThreadNotifyRoutine untuk menyiapkan rutinitas pemberitahuan pembuatan utas mereka, dinyatakan sebagai berikut:

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

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.

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

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ntddk.h (termasuk Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)