IDebugEventCallbacks::LoadModule 메서드(dbgeng.h)

LoadModule 콜백 메서드는 대상에서 모듈 로드 디버깅 이벤트가 발생할 때 엔진에서 호출됩니다.

구문

HRESULT LoadModule(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp
);

매개 변수

[in] ImageFileHandle

모듈의 이미지 파일에 대한 핸들을 지정합니다. 이 정보를 사용할 수 없는 경우 ImageFileHandle 은 NULL이 됩니다.

[in] BaseOffset

대상의 메모리 주소 공간에서 모듈의 기본 주소를 지정합니다. 이 정보를 사용할 수 없는 경우 BaseOffset 은 NULL이 됩니다.

[in] ModuleSize

모듈의 이미지 크기를 바이트 단위로 지정합니다. 이 정보를 사용할 수 없는 경우 ModuleSize 는 NULL이 됩니다.

[in, optional] ModuleName

디버거 엔진에서 사용하는 간소화된 모듈 이름을 지정합니다. 대부분의 경우 확장명을 제외한 이미지 파일 이름과 일치합니다. 이 정보를 사용할 수 없는 경우 ModuleName 은 NULL이 됩니다.

[in, optional] ImageName

경로를 포함할 수 있는 모듈의 이미지 파일 이름을 지정합니다. 이 정보를 사용할 수 없는 경우 ImageName 은 NULL이 됩니다.

[in] CheckSum

모듈 이미지 파일의 체크섬을 지정합니다. 이 정보를 사용할 수 없는 경우 CheckSum 은 NULL이 됩니다.

[in] TimeDateStamp

모듈 이미지 파일의 시간 및 날짜 스탬프를 지정합니다. 이 정보를 사용할 수 없는 경우 TimeDateStamp 는 0이 됩니다.

반환 값

이 메서드는 엔진이 이 이벤트를 처리한 후 대상의 실행을 진행하는 방법을 나타내는 DEBUG_STATUS_XXX 값을 반환합니다. 엔진이 이 값을 처리하는 방법에 대한 자세한 내용은 이벤트 모니터링을 참조하세요.

설명

이 메서드는 IDebugEventCallbacks::GetInterestMask에서 반환된 마스크에 DEBUG_EVENT_LOAD_MODULE 플래그가 설정된 경우에만 엔진에서 호출됩니다.

이 메서드를 호출한 후 엔진은 비트 플래그 DEBUG_CSS_LOADS 포함하는 Flags 매개 변수를 사용하여 IDebugEventCallbacks::ChangeSymbolState를 호출합니다.

이벤트 처리에 대한 자세한 내용은 이벤트 모니터링을 참조하세요.

요구 사항