IDebugControl2::Metode output (dbgeng.h)

Artikel
08/07/2023

Metode Output memformat string dan mengirim hasilnya ke panggilan balik output yang telah didaftarkan ke klien mesin.

Sintaks

HRESULT Output(
  [in] ULONG Mask,
  [in] PCSTR Format,
       ...   
);

Parameter

[in] Mask

Menentukan bidang bit jenis output. Lihat DEBUG_OUTPUT_XXX untuk nilai yang mungkin.

[in] Format

Menentukan string format, seperti dalam printf. Secara umum, karakter konversi berfungsi persis seperti di C. Untuk karakter konversi floating-point, argumen 64-bit ditafsirkan sebagai angka floating-point 32-bit kecuali jika pengubah l digunakan.

Karakter konversi %p didukung, tetapi mewakili penunjuk di ruang alamat target. Ini tidak dapat memiliki pengubah dan menggunakan pemformatan alamat internal debugger. Karakter konversi tambahan berikut didukung.

Karakter	Jenis Argumen	Argumen	Teks dicetak
%p	ULONG64	Penunjuk di ruang alamat	Nilai penunjuk.
%N	DWORD_PTR (32 atau 64 bit, tergantung pada arsitektur host)	Penunjuk di ruang alamat virtual host	Nilai penunjuk. (Ini setara dengan karakter C %p standar.)
%I	ULONG64	Nilai 64-bit apa pun	Nilai yang ditentukan. Jika ini lebih besar dari 0xFFFFFFFF, ini dicetak sebagai nilai 64-bit. Jika tidak, itu dicetak sebagai nilai 32-bit.
%ma	ULONG64	Alamat string ASCII yang dihentikan NULL di ruang alamat virtual proses	String yang ditentukan.
%mu	ULONG64	Alamat string Unicode yang dihentikan NULL di ruang alamat virtual proses	String yang ditentukan.
%msa	ULONG64	Alamat struktur ANSI_STRING di ruang alamat virtual proses	String yang ditentukan.
%msu	ULONG64	Alamat struktur UNICODE_STRING di ruang alamat virtual proses	String yang ditentukan.
%y	ULONG64	Alamat dalam ruang alamat virtual proses item dengan informasi simbol	String yang berisi nama simbol yang ditentukan (dan perpindahan, jika ada).
%ly	ULONG64	Alamat dalam ruang alamat virtual proses item dengan informasi simbol	String yang berisi nama simbol yang ditentukan (dan perpindahan, jika ada), serta informasi baris sumber yang tersedia.

...

Menentukan parameter tambahan yang berisi nilai yang akan dimasukkan ke dalam output selama pemformatan.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Saat menghasilkan string output yang sangat besar, dimungkinkan untuk mencapai batas mesin debugger atau sistem operasi. Misalnya, beberapa versi mesin debugger memiliki batas karakter 16K untuk satu output. Jika Anda menemukan bahwa output yang sangat besar terpotong, Anda mungkin perlu membagi output Anda menjadi beberapa permintaan.