DEBUG_OUTCTL_XXX

Статья
02/07/2024

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

Нижние биты должны быть точно одним из следующих значений.

Значение	Описание
DEBUG_OUTCTL_THIS_CLIENT	Выходные данные, созданные методами, вызываемыми этим клиентом, будут отправляться только в обратные вызовы выходных данных этого клиента.
DEBUG_OUTCTL_ALL_CLIENTS	Выходные данные будут отправляться всем клиентам.
DEBUG_OUTCTL_ALL_OTHER_CLIENTS	Выходные данные будут отправляться всем клиентам (за исключением клиента, который создал выходные данные).
DEBUG_OUTCTL_IGNORE	Выходные данные будут немедленно удалены и не будут зарегистрированы или отправлены в обратные вызовы.
DEBUG_OUTCTL_LOG_ONLY	Выходные данные записываются в журнал, но не отправляются в обратные вызовы.

Более высокие биты битового поля могут содержать следующие значения.

Значение	Описание
DEBUG_OUTCTL_NOT_LOGGED	Не помещайте выходные данные этого клиента в глобальный файл журнала.
DEBUG_OUTCTL_OVERRIDE_MASK	Отправляет выходные данные клиентам независимо от того, допускает ли это маска вывода клиента.
DEBUG_OUTCTL_DML	Для выходных данных, поддерживающих язык разметки отладчика (DML), отправляет выходные данные в формате DML.

Чтобы создать допустимое битовое поле элемента управления выходными данными, возьмите ровно одно значение из первой таблицы вместе с нулевыми или более значениями из второй таблицы и объедините их с помощью побитового оператора OR.

Значение по умолчанию битового поля элемента управления выходными данными — DEBUG_OUTCTL_ALL_CLIENTS.

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

Значение	Описание
DEBUG_OUTCTL_AMBIENT_DML	Задает для нового элемента управления выходными данными то же значение, что и текущий элемент управления выходными данными, и указывает, что выходные данные будут иметь формат DML.
DEBUG_OUTCTL_AMBIENT_TEXT	Задает для нового элемента управления выходными данными то же значение, что и текущий элемент управления выходными данными, и указывает, что выходные данные будут иметь текстовый формат.
DEBUG_OUTCTL_AMBIENT	То же, что и DEBUG_OUTCTL_AMBIENT_TEXT.

Требования

Заголовок

DbgEng.h (включая DbgEng.h)