IDebugSymbols::SetScope 메서드(dbgeng.h)
SetScope 메서드는 현재 범위를 설정합니다.
통사론
HRESULT SetScope(
[in] ULONG64 InstructionOffset,
[in, optional] PDEBUG_STACK_FRAME ScopeFrame,
[in, optional] PVOID ScopeContext,
[in] ULONG ScopeContextSize
);
매개 변수
[in] InstructionOffset
범위의 현재 명령에 대한 프로세스의 가상 주소 공간의 위치를 지정합니다. 이는 ScopeFrame 및 ScopeContext 모두 NULL 경우에만 사용됩니다. 그렇지 않으면 무시됩니다.
[in, optional] ScopeFrame
범위의 스택 프레임을 지정합니다. 이 구조에 대한 자세한 내용은 DEBUG_STACK_FRAME참조하세요.
[in, optional] ScopeContext
범위의 스레드 컨텍스트지정합니다. 스레드 컨텍스트의 형식은 대상의 유효 프로세서에 대한 CONTEXT 구조입니다. ScopeContext 버퍼는 이 구조를 유지할 수 있을 만큼 커야 합니다. ScopeContext NULL 경우 현재 레지스터 컨텍스트 대신 사용됩니다.
[in] ScopeContextSize
ScopeContext 버퍼의 크기를 지정합니다.
반환 값
이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값 참조하세요.
| 반환 코드 | 묘사 |
|---|---|
|
InstructionOffset, ScopeFrame및 ScopeContext 식별된 범위는 이전 범위와 동일합니다. |
|
범위가 변경되었습니다. |
발언
InstructionOffset 제공된 경우 범위를 사용하여 기호 이름을 조회할 수 있습니다. 그러나 이러한 기호의 값은 사용할 수 없습니다.
범위를 이전 상태로 설정하려면 ScopeContext 제공해야 합니다. 항상 필요한 것은 아닙니다(예를 들어 등록하지 않고 기호에만 액세스하려는 경우). 범위를 현재 스택의 프레임으로 설정하려면 SetScopeFrameByIndex 사용할 수 있습니다.
범위에 대한 자세한 내용은 범위 및 기호 그룹참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | dbgeng.h(Dbgeng.h 포함) |