Метод 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, в выходные обратные вызовы отправляется только стандартный текст запроса.
...
Указывает дополнительные параметры, представляющие значения, которые будут вставлены в выходные данные во время форматирования.
Возвращаемое значение
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
Комментарии
OutputPrompt и OutputPromptWide можно использовать для запроса ввода данных у пользователя.
Стандартный запрос будет отправлен в обратные вызовы выходных данных перед форматированным текстом, описанным в параметре Format. Содержимое стандартного запроса возвращается методом GetPromptText.
Текст запроса отправляется в обратные вызовы с DEBUG_OUTPUT_PROMPT маской вывода.
Дополнительные сведения о запросе пользователя см. в разделе Использование входных и выходных данных.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | dbgeng.h (включая Dbgeng.h) |