PDEBUG_EXTENSION_INITIALIZE 콜백 함수(dbgeng.h)

DbgEng 확장 DLL을 로드한 후 엔진에서 DebugExtensionInitialize 콜백 함수를 호출합니다.

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

구문

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

HRESULT PdebugExtensionInitialize(
  [out] PULONG Version,
  [out] PULONG Flags
)
{...}

[out] Version

확장의 버전을 받습니다. 상위 16비트에는 주 버전 번호가 포함되고 하위 16비트에는 부 버전 번호가 포함됩니다.

[out] Flags

이 값을 0으로 설정합니다. (나중에 사용할 수 있습니다.)

반환 코드	설명
S_OK	확장이 성공적으로 초기화되었습니다.

다른 값은 확장 DLL을 초기화할 수 없으며 엔진이 언로드한다는 것을 나타냅니다.

엔진은 각 확장 DLL에서 이름으로 이 함수를 찾습니다. 이 함수는 DbgEng 확장 DLL에서 내보내야 합니다.

dbgeng.h에 있는 매크로 DEBUG_EXTENSION_VERSION 사용하여 버전 번호를 설정할 수 있습니다. 예를 들면 다음과 같습니다.

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

이 함수의 구현은 확장 DLL에 필요한 전역 변수를 초기화해야 합니다.

이 함수가 호출될 때 활성 세션이 있거나 없을 수 있으므로 확장에서 세션 정보를 쿼리할 수 있다고 가정해서는 안 됩니다.

함수 형식은 dbgeng.h에서 PDEBUG_EXTENSION_INITIALIZE 정의됩니다.


대상 플랫폼	유니버설
헤더	dbgeng.h