Metode IDebugControl2::OutputStackTrace (dbgeng.h)

Artikel
02/23/2024

Metode OutputStackTrace menghasilkan bingkai tumpukan yang disediakan atau bingkai tumpukan saat ini.

Sintaks

HRESULT OutputStackTrace(
  [in]           ULONG              OutputControl,
  [in, optional] PDEBUG_STACK_FRAME Frames,
  [in]           ULONG              FramesSize,
  [in]           ULONG              Flags
);

Parameter

[in] OutputControl

Menentukan tempat untuk mengirim output. Untuk nilai yang mungkin, lihat DEBUG_OUTCTL_XXX.

[in, optional] Frames

Menentukan array bingkai tumpukan ke output. Jumlah elemen dalam array ini adalah FramesSize. Jika BingkaiNULL, bingkai tumpukan saat ini akan digunakan.

[in] FramesSize

Menentukan jumlah bingkai yang akan dihasilkan.

[in] Flags

Menentukan bendera bit yang menentukan informasi apa yang akan dihasilkan untuk setiap bingkai. Bendera dapat berupa kombinasi nilai apa pun dari tabel berikut.

Bendera	Deskripsi
DEBUG_STACK_ARGUMENTS	Menampilkan tiga bagian pertama memori tumpukan pada bingkai setiap panggilan. Pada platform tempat parameter diteruskan pada tumpukan, dan kode untuk bingkai menggunakan argumen tumpukan, nilai-nilai ini akan menjadi argumen ke fungsi.
DEBUG_STACK_FUNCTION_INFO	Menampilkan informasi tentang fungsi yang sesuai dengan bingkai. Ini termasuk konvensi panggilan dan informasi kelalaian pointer bingkai (FPO).
DEBUG_STACK_SOURCE_LINE	Menampilkan informasi baris sumber untuk setiap bingkai pelacakan tumpukan.
DEBUG_STACK_FRAME_ADDRESSES	Menampilkan alamat pengembalian, alamat bingkai sebelumnya, dan alamat relevan lainnya untuk setiap bingkai.
DEBUG_STACK_COLUMN_NAMES	Menampilkan nama kolom.
DEBUG_STACK_NONVOLATILE_REGISTERS	Menampilkan konteks register yang tidak volatil untuk setiap bingkai. Ini hanya bermakna untuk beberapa platform.
DEBUG_STACK_FRAME_NUMBERS	Menampilkan nomor bingkai.
DEBUG_STACK_PARAMETERS	Menampilkan nama dan nilai parameter seperti yang diberikan dalam informasi simbol.
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY	Hanya menampilkan alamat pengembalian dalam alamat bingkai tumpukan.
DEBUG_STACK_FRAME_MEMORY_USAGE	Menampilkan jumlah byte yang memisahkan bingkai.
DEBUG_STACK_PARAMETERS_NEWLINE	Menampilkan setiap parameter beserta jenis dan nilainya pada baris baru.