Metode IDebugControl3::OutputPromptVaList (dbgeng.h)

Artikel
02/26/2024

Metode OutputPromptVaList memformat dan mengirim permintaan pengguna ke objek panggilan balik output.

Sintaks

HRESULT OutputPromptVaList(
  [in]           ULONG   OutputControl,
  [in, optional] PCSTR   Format,
  [in]           va_list Args
);

Parameter

[in] OutputControl

Menentukan kontrol output yang menentukan panggilan balik output klien mana yang akan menerima output. Untuk nilai yang mungkin, lihat DEBUG_OUTCTL_XXX.

[in, optional] Format

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

Karakter konversi %p didukung, tetapi mewakili penunjuk di ruang alamat target. Ini mungkin tidak 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)	Pointer 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.

Jika FormatNULL, hanya teks perintah standar yang dikirim ke panggilan balik output.

[in] Args

Menentukan parameter tambahan yang mewakili nilai yang akan dimasukkan ke dalam output selama pemformatan. Arg harus diinisialisasi menggunakan va_start. Metode ini tidak memanggil va_end.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

OutputPromptVaList dan OutputPromptVaListWide dapat digunakan untuk meminta input kepada pengguna.

Perintah standar akan dikirim ke panggilan balik output sebelum teks yang diformat yang dijelaskan oleh Format. Konten prompt standar dikembalikan oleh metode GetPromptText.

Teks perintah dikirim ke panggilan balik output dengan kumpulan masker output DEBUG_OUTPUT_PROMPT .

Untuk informasi selengkapnya tentang meminta pengguna, lihat Menggunakan Input dan Output.