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

Статья
08/07/2023

Метод 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	Адрес в виртуальном адресном пространстве процесса элемента с информацией о символах.	Строка, содержащая имя указанного символа (и смещение, если таковое имеется), а также любые доступные сведения об исходной строке.

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

[in] Args

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

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

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

Дополнительные сведения о запросе пользователя см. в разделе Использование входных и выходных данных.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h, Stdarg.h)