Método IDebugSymbols3::GetScope (dbgeng.h)
El método GetScope devuelve información sobre el ámbito actual.
Sintaxis
HRESULT GetScope(
[out, optional] PULONG64 InstructionOffset,
[out, optional] PDEBUG_STACK_FRAME ScopeFrame,
[out, optional] PVOID ScopeContext,
[in] ULONG ScopeContextSize
);
Parámetros
[out, optional] InstructionOffset
Recibe la ubicación en el espacio de direcciones virtuales del proceso de la instrucción actual del ámbito actual.
[out, optional] ScopeFrame
Recibe la estructura DEBUG_STACK_FRAME que representa el marco de pila del ámbito actual.
[out, optional] ScopeContext
Recibe el contexto de subproceso de del ámbito actual. El tipo del contexto del subproceso es la estructura CONTEXT del procesador efectivo del destino. El búfer ScopeContext debe ser lo suficientemente grande como para contener esta estructura.
[in] ScopeContextSize
Especifica el tamaño del búfer ScopeContext.
Valor devuelto
Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El tamaño del búfer ScopeContext no era lo suficientemente grande como para contener el contexto del ámbito. |
Observaciones
Para obtener más información sobre los ámbitos, vea Ámbitos y grupos de símbolos.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h, Ntddk.h) |