Поделиться через


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

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

Синтаксис

HRESULT OutputPrompt(
  [in]           ULONG OutputControl,
  [in, optional] PCSTR Format,
                 ...   
);

Параметры

[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, в выходные обратные вызовы отправляется только стандартный текст запроса.

...

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

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

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

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

Комментарии

OutputPrompt и OutputPromptWide можно использовать для запроса ввода данных у пользователя.

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

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

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

Требования

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

См. также раздел

ControlledOutput

DEBUG_OUTPUT_XXX

GetPromptText

IDebugControl

IDebugControl2

IDebugControl3

OutputPromptVaList