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

아티클
08/07/2023

상태가 변경되면 엔진에서 ChangeEngineState 콜백 메서드를 호출합니다.

구문

HRESULT ChangeEngineState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

매개 변수

[in] Flags

엔진 상태에서 발생한 변경의 유형을 나타내는 비트 집합을 지정합니다. 다음 비트 플래그를 설정할 수 있습니다.

값	Description
DEBUG_CES_CURRENT_THREAD	현재 스레드가 변경되었습니다. 즉, 현재 대상 및 현재 프로세스도 변경되었을 수 있습니다.
DEBUG_CES_EFFECTIVE_PROCESSOR	유효 프로세서가 변경되었습니다.
DEBUG_CES_BREAKPOINTS	하나 이상의 중단점이 변경되었습니다.
DEBUG_CES_CODE_LEVEL	코드 해석 수준이 변경되었습니다.
DEBUG_CES_EXECUTION_STATUS	실행 상태 변경되었습니다.
DEBUG_CES_ENGINE_OPTIONS	엔진 옵션이 변경되었습니다.
DEBUG_CES_LOG_FILE	로그 파일이 열리거나 닫혔습니다.
DEBUG_CES_RADIX	기본 radix가 변경되었습니다.
DEBUG_CES_EVENT_FILTERS	이벤트 필터가 변경되었습니다.
DEBUG_CES_PROCESS_OPTIONS	현재 프로세스에 대한 프로세스 옵션이 변경되었습니다.
DEBUG_CES_EXTENSIONS	확장 DLL이 로드되거나 언로드되었습니다. 자세한 내용은 디버거 확장 DLL 로드를 참조하세요.
DEBUG_CES_SYSTEMS	대상이 추가되거나 제거되었습니다.
DEBUG_CES_ASSEMBLY_OPTIONS	어셈블리 옵션이 변경되었습니다.
DEBUG_CES_EXPRESSION_SYNTAX	기본 식 구문이 변경되었습니다.
DEBUG_CES_TEXT_REPLACEMENTS	텍스트 바꾸기가 변경되었습니다.

[in] Argument

엔진 상태 변경에 대한 추가 정보를 제공합니다. Flags 매개 변수에 둘 이상의 비트 플래그가 설정된 경우 Argument 매개 변수는 사용되지 않습니다. 그렇지 않으면 Argument 값의 해석은 Flags 값에 따라 달라집니다.

DEBUG_CES_CURRENT_THREAD

Argument 값은 현재 엔진 스레드 ID이거나 현재 스레드가 없는 경우 DEBUG_ANY_ID. 자세한 내용은 스레드 및 프로세스를 참조하세요.

DEBUG_CES_EFFECTIVE_PROCESSOR

Argument 값은 유효 프로세서의 형식입니다.

DEBUG_CES_BREAKPOINTS

Argument 값은 변경된 중단점의 중단점 ID이거나 둘 이상의 중단점이 변경된 경우 DEBUG_ANY_ID. 자세한 내용은 중단점을 참조하세요.

DEBUG_CES_CODE_LEVEL

Argument 값은 코드 해석 수준입니다.

DEBUG_CES_EXECUTION_STATUS

Argument 값은 비트 플래그 DEBUG_STATUS_INSIDE_WAIT 결합할 수 있는 실행 상태(DEBUG_STATUS_XXX 항목에 설명되어 있음)입니다. waitForEvent 호출이 보류 중인 경우 DEBUG_STATUS_INSIDE_WAIT 설정됩니다. 자세한 내용은 세션 및 실행 모델 디버깅을 참조하세요.

DEBUG_CES_ENGINE_OPTIONS

인수 값은 엔진 옵션입니다.

DEBUG_CES_LOG_FILE

로그 파일을 연 경우 Argument 값은 TRUE 이고 로그 파일이 닫힌 경우 FALSE 입니다.

DEBUG_CES_RADIX

Argument의 값은 기본 radix입니다.

DEBUG_CES_EVENT_FILTERS

Argument 값은 변경된 이벤트 필터의 인덱스이거나 둘 이상의 이벤트 필터가 변경된 경우 DEBUG_ANY_ID.

DEBUG_CES_PROCESS_OPTIONS

Argument 값은 현재 프로세스에 대한 프로세스 옵션입니다.

DEBUG_CES_EXTENSIONS

Argument 값은 0입니다.

DEBUG_CES_SYSTEMS

Argument 값은 추가된 대상의 대상 ID이거나, 대상이 제거된 경우 DEBUG_ANY_ID.

DEBUG_CES_ASSEMBLE_OPTIONS

인수 값은 어셈블리 옵션입니다.

DEBUG_CES_EXPRESSION_SYNTAX

Argument 값은 기본 식 구문입니다.

DEBUG_CES_TEXT_REPLACEMENTS

Argument 값은 DEBUG_ANY_ID.

반환 값

반환 값은 원격 프로시저 호출 오류를 나타내지 않는 한 엔진에서 무시됩니다. 이 경우 이 IDebugEventCallbacks 개체가 등록된 클라이언트는 사용하지 않도록 설정됩니다.

설명

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

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

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	dbgeng.h(Dbgeng.h 포함)

다음을 통해 공유