IDebugSymbols3::Metode GetScope (dbgeng.h)

Metode GetScope mengembalikan informasi tentang cakupan saat ini.

Sintaks

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

Parameter

[out, optional] InstructionOffset

Menerima lokasi di ruang alamat virtual proses dari instruksi cakupan saat ini.

[out, optional] ScopeFrame

Menerima struktur DEBUG_STACK_FRAME yang mewakili bingkai tumpukan cakupan saat ini.

[out, optional] ScopeContext

Menerima konteks utas cakupan saat ini. Jenis konteks utas adalah struktur CONTEXT untuk prosesor efektif target. Buffer ScopeContext harus cukup besar untuk menahan struktur ini.

[in] ScopeContextSize

Menentukan ukuran buffer ScopeContext.

Mengembalikan nilai

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode Deskripsi
S_OK
Metode berhasil.
E_INVALIDARG
Ukuran buffer ScopeContext tidak cukup besar untuk menahan konteks cakupan.

Keterangan

Untuk informasi selengkapnya tentang cakupan, lihat Cakupan dan Grup Simbol.

Persyaratan

   
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h, Ntddk.h)

Lihat juga

IDebugControl::GetEffectiveProcessorType

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

ResetScope

SetScope