PsSetCreateThreadNotifyRoutineEx 함수(ntddk.h)

아티클
02/29/2024

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