Метод IDebugControl3::OutputPromptVaList (dbgeng.h)

Статья
02/06/2025

Метод outputPromptVaList форматирует и отправляет пользователю запрос на объекты обратного вызова.

Синтаксис

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

Параметры

[in] OutputControl

Указывает выходной элемент управления, определяющий, какие из выходных вызовов клиента будут получать выходные данные. Возможные значения см. в разделе DEBUG_OUTCTL_XXX.

[in, optional] Format

Указывает строку формата, как в printf. Как правило, символы преобразования работают точно так же, как и в C. Для символов преобразования с плавающей запятой 64-разрядный аргумент интерпретируется как 32-разрядное число с плавающей запятой, если не используется модификатор l.

Символ преобразования %p поддерживается, но он представляет указатель в адресном пространстве целевого объекта. Он может не иметь модификаторов и использует внутреннее форматирование адресов отладчика. Поддерживаются следующие дополнительные символы преобразования.

Характер	Тип аргумента	Аргумент	Печатный текст
%p	ULONG64	Указатель в адресном пространстве.	Значение указателя.
%N	DWORD_PTR (32 или 64 бита в зависимости от архитектуры узла)	Указатель на виртуальное адресное пространство узла.	Значение указателя. (Это эквивалентно стандартному символу C %p.)
%I	ULONG64	Любое 64-разрядное значение.	Указанное значение. Если это больше 0xFFFFFFFF, оно выводится в виде 64-разрядного значения; в противном случае он печатается как 32-разрядное значение.
%ma	ULONG64	Адрес строки ASCII, завершаемой null, в виртуальном адресном пространстве процесса.	Указанная строка.
%mu	ULONG64	Адрес строки Юникода, завершаемой null, в виртуальном адресном пространстве процесса.	Указанная строка.
%msa	ULONG64	Адрес структуры ANSI_STRING в виртуальном адресном пространстве процесса.	Указанная строка.
%msu	ULONG64	Адрес структуры UNICODE_STRING в виртуальном адресном пространстве процесса.	Указанная строка.
%y	ULONG64	Адрес в виртуальном адресном пространстве процесса элемента с информацией о символах.	Строка, содержащая имя указанного символа (и смещение, если таковое есть).
%ly	ULONG64	Адрес в виртуальном адресном пространстве процесса элемента с информацией о символах.	Строка, содержащая имя указанного символа (и смещения, если таковые имеются), а также любые доступные сведения о исходной строке.

Если форматNULL, то в выходные обратные вызовы отправляется только стандартный текст запроса.

[in] Args

Указывает дополнительные параметры, представляющие значения, которые будут вставлены в выходные данные во время форматирования. Args необходимо инициализировать с помощью va_start. Этот метод не вызывает va_end.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

OutputPromptVaList и OutputPromptVaListWide можно использовать для запроса пользователя на ввод.

Стандартный запрос будет отправлен в выходные обратные вызовы перед форматированным текстом, описанным Format. Содержимое стандартного запроса возвращается методом GetPromptText.

Текст запроса отправляется в выходные обратные вызовы с набором маски вывода DEBUG_OUTPUT_PROMPT.

Дополнительные сведения о запросе пользователя см. в разделе Using Input and Output.