DEBUG_OUTCTL_XXX

Artikel
02/07/2024

Die DEBUG_OUTCTL_XXX-Konstanten werden für die Ausgabesteuerung verwendet. Die Konstanten bilden ein Bitfeld, das die aktuelle Richtlinie angibt, wohin die Ausgabe gesendet werden soll. Das Bitfeld ist in zwei Abschnitte unterteilt.

Die unteren Bits müssen genau einer der folgenden Werte sein.

Wert	BESCHREIBUNG
DEBUG_OUTCTL_THIS_CLIENT	Die Ausgabe, die von methoden generiert wird, die von diesem Client aufgerufen werden, wird nur an die Ausgaberückrufe dieses Clients gesendet.
DEBUG_OUTCTL_ALL_CLIENTS	Die Ausgabe wird an alle Clients gesendet.
DEBUG_OUTCTL_ALL_OTHER_CLIENTS	Die Ausgabe wird an alle Clients gesendet (mit Ausnahme des Clients, der die Ausgabe generiert hat).
DEBUG_OUTCTL_IGNORE	Die Ausgabe wird sofort verworfen und nicht protokolliert oder an Rückrufe gesendet.
DEBUG_OUTCTL_LOG_ONLY	Die Ausgabe wird protokolliert, aber nicht an Rückrufe gesendet.

Die höheren Bits des Bitfelds können die folgenden Werte enthalten.

Wert	BESCHREIBUNG
DEBUG_OUTCTL_NOT_LOGGED	Legen Sie die Ausgabe dieses Clients nicht in die globale Protokolldatei ein.
DEBUG_OUTCTL_OVERRIDE_MASK	Sendet die Ausgabe an Clients, unabhängig davon, ob die Ausgabemaske des Clients dies zulässt.
DEBUG_OUTCTL_DML	Für eine Ausgabe, die Debugger Markup Language (DML) unterstützt, sendet die Ausgabe im DML-Format.

Um ein gültiges Ausgabesteuerungsbitfeld zu erstellen, nehmen Sie genau einen Wert aus der ersten Tabelle zusammen mit null oder mehr Werten aus der zweiten Tabelle, und kombinieren Sie sie mithilfe des bitweisen OR-Operators.

Der Standardwert des Bitfelds der Ausgabesteuerung ist DEBUG_OUTCTL_ALL_CLIENTS.

Alternativ zum Erstellen eines eigenen Ausgabesteuerungsbitfelds können Sie einen der folgenden Werte verwenden.

Wert	BESCHREIBUNG
DEBUG_OUTCTL_AMBIENT_DML	Legt das neue Ausgabesteuerelement auf den gleichen Wert wie das aktuelle Ausgabesteuerelement fest und gibt an, dass die Ausgabe im DML-Format erfolgt.
DEBUG_OUTCTL_AMBIENT_TEXT	Legt das neue Ausgabesteuerelement auf den gleichen Wert wie das aktuelle Ausgabesteuerelement fest und gibt an, dass die Ausgabe im Textformat erfolgt.
DEBUG_OUTCTL_AMBIENT	Identisch mit DEBUG_OUTCTL_AMBIENT_TEXT.

Anforderungen

Header

DbgEng.h (einschließlich DbgEng.h)