PsSetLoadImageNotifyRoutine 함수(ntddk.h)

PsSetLoadImageNotifyRoutine 루틴은 이미지(예: DLL 또는 EXE)가 로드되거나 메모리에 매핑될 때마다 이후에 알림을 받는 드라이버 제공 콜백을 등록합니다.

구문

NTSTATUS PsSetLoadImageNotifyRoutine(
  [in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);

매개 변수

[in] NotifyRoutine

로드 이미지 알림에 대한 호출자 구현 PLOAD_IMAGE_NOTIFY_ROUTINE 콜백 루틴에 대한 포인터입니다.

반환 값

PsSetLoadImageNotifyRoutine 은 STATUS_SUCCESS 반환하거나 콜백 등록에 실패한 경우 STATUS_INSUFFICIENT_RESOURCES 반환합니다.

설명

최고 수준의 시스템 프로파일링 드라이버는 PsSetLoadImageNotifyRoutine 을 호출하여 부하 이미지 알림 루틴을 설정할 수 있습니다( PLOAD_IMAGE_NOTIFY_ROUTINE 참조).

로드 이미지 알림을 수신하기 위해 동시에 등록할 수 있는 최대 드라이버 수는 8개입니다. 드라이버가 PsSetLoadImageNotifyRoutine 을 호출하여 추가 알림 루틴을 등록하려고 할 때 로드 이미지 알림 루틴의 최대 수가 이미 등록된 경우 PsSetLoadImageNotifyRoutine 은 실패하고 STATUS_INSUFFICIENT_RESOURCES 반환합니다.

참고

  • Windows 8.1 대한 업데이트는 로드 이미지 알림을 수신하도록 등록된 최대 드라이버 수를 8개에서 64개로 늘림합니다. 이 업데이트는 2014년 4월 8일부터 Windows 업데이트 통해 제공되는 누적 업데이트의 일부로 설치됩니다. 또한 이 누적 업데이트는 에서 https://support.microsoft.com/kb/2919355사용할 수 있습니다.
  • SP1(서비스 팩 1)이 있는 Windows 7 사용자는 핫픽스를 설치하여 로드 이미지 알림을 수신하도록 등록된 최대 드라이버 수를 8개에서 64개로 늘릴 수 있습니다. 이 핫픽스는 에서 https://support.microsoft.com/kb/2922790사용할 수 있습니다.
드라이버는 언로드하기 전에 등록하는 콜백을 제거해야 합니다. PsRemoveLoadImageNotifyRoutine 루틴을 호출하여 콜백을 제거할 수 있습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000부터 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 ntddk.h(Ntddk.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)

추가 정보

PLOAD_IMAGE_NOTIFY_ROUTINE

PsGetCurrentProcessId

PsRemoveLoadImageNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetCreateThreadNotifyRoutine