PsSetCreateThreadNotifyRoutineEx 函式 (ntddk.h)
PsSetCreateThreadNotifyRoutineEx 例程會註冊驅動程式提供的回呼,該回呼會在建立新線程和刪除這類線程時收到通知。
語法
NTSTATUS PsSetCreateThreadNotifyRoutineEx(
[in] PSCREATETHREADNOTIFYTYPE NotifyType,
[in] PVOID NotifyInformation
);
參數
[in] NotifyType
PSCREATETHREADNOTIFYTYPE 值,指出線程通知的類型。
[in] NotifyInformation
提供指定線程通知類型的通知信息位址。 如果 NotifyType 是 PsCreateThreadNotifyNonSystem 或 PsCreateThreadNotifySubsystems,則 NotifyInformation 應該是驅動程式實作 PCREATE_THREAD_NOTIFY_ROUTINE的指標。
傳回值
PsSetCreateThreadNotifyRoutineEx 會傳回STATUS_SUCCESS,或者如果回呼註冊失敗,則會傳回STATUS_INSUFFICIENT_RESOURCES。
言論
最高層級驅動程式可以呼叫 PsSetCreateThreadNotifyRoutineEx 來設定其線程建立通知例程。
例如,IFS 或最高層級的系統分析驅動程式可能會註冊這類線程建立回呼,以追蹤整個系統的建立和刪除線程與驅動程式的內部狀態。
如果 NotifyType 是 psCreateThreadNotifyNonSystem ,則 PsSetCreateThreadNotifyRoutineEx 例程與執行回呼的內容 PsSetCreateThreadNotifyRoutine 不同。 使用 PsSetCreateThreadNotifyRoutine時,回呼會在建立者線程上執行。 PsSetCreateThreadNotifyRoutineEx時,回呼會在新建立的線程上執行。
驅動程式必須先移除它所註冊的任何回呼函式,才能卸除。 您可以呼叫 PsRemoveCreateThreadNotifyRoutine 例程來移除回呼。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 10 開始提供。 |
目標平臺 | 普遍 |
標頭 | ntddk.h (包括 Ntddk.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
另請參閱
PsRemoveCreateThreadNotifyRoutine
PsSetCreateProcessNotifyRoutine