Поделиться через


Метод IDebugSymbols3::GetScope (dbgeng.h)

Метод GetScope возвращает сведения о текущем область.

Синтаксис

HRESULT GetScope(
  [out, optional] PULONG64           InstructionOffset,
  [out, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [out, optional] PVOID              ScopeContext,
  [in]            ULONG              ScopeContextSize
);

Параметры

[out, optional] InstructionOffset

Получает расположение в виртуальном адресном пространстве процесса текущей инструкции область.

[out, optional] ScopeFrame

Получает структуру DEBUG_STACK_FRAME, представляющую кадр стека текущего область.

[out, optional] ScopeContext

Получает контекст потока текущего область. Тип контекста потока — это структура CONTEXT для эффективного процессора целевого объекта. Буфер ScopeContext должен быть достаточно большим, чтобы вместить эту структуру.

[in] ScopeContextSize

Указывает размер буфера ScopeContext.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата Описание
S_OK
Метод выполнен успешно.
E_INVALIDARG
Размер буфера ScopeContext не был достаточным для хранения контекста область.

Комментарии

Дополнительные сведения об областях см. в разделе Области и группы символов.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h, Ntddk.h)

См. также раздел

IDebugControl::GetEffectiveProcessorType

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

ResetScope

SetScope