IDebugControl::Output-Methode (dbgeng.h)

Artikel
02/06/2025

Die Output-Methode formatiert eine Zeichenfolge und sendet das Ergebnis an Ausgaberückrufe, die bei den Clients des Moduls registriert wurden.

Syntax

HRESULT Output(
  [in] ULONG Mask,
  [in] PCSTR Format,
       ...   
);

Parameter

[in] Mask

Gibt das Bitfeld des Ausgabetyps an. Mögliche Werte finden Sie unter DEBUG_OUTPUT_XXX.

[in] Format

Gibt die Formatzeichenfolge wie in printf-an. Im Allgemeinen funktionieren Konvertierungszeichen genau wie in C. Für die Gleitkommakonvertierungszeichen wird das 64-Bit-Argument als 32-Bit-Gleitkommazahl interpretiert, es sei denn, der l Modifizierer wird verwendet.

Das %p Konvertierungszeichen wird unterstützt, stellt jedoch einen Zeiger im Adressraum eines Ziels dar. Es können keine Modifizierer vorhanden sein und die interne Adressformatierung des Debuggers verwendet werden. Die folgenden zusätzlichen Konvertierungszeichen werden unterstützt.

Zeichen	Argumenttyp	Argument	Gedruckter Text
%p	ULONG64	Zeiger in einem Adressraum	Der Wert des Zeigers.
%N	DWORD_PTR (32 oder 64 Bit, abhängig von der Architektur des Hosts)	Zeiger im virtuellen Adressraum des Hosts	Der Wert des Zeigers. (Dies entspricht dem Standardzeichen C %p.)
%I	ULONG64	Beliebiger 64-Bit-Wert	Der angegebene Wert. Wenn dies größer als 0xFFFFFFFF ist, wird sie als 64-Bit-Wert gedruckt. Andernfalls wird sie als 32-Bit-Wert gedruckt.
%ma	ULONG64	Adresse einer MIT NULL beendeten ASCII-Zeichenfolge im virtuellen Adressraum des Prozesses	Die angegebene Zeichenfolge.
%mu	ULONG64	Adresse einer MIT NULL beendeten Unicode-Zeichenfolge im virtuellen Adressraum des Prozesses	Die angegebene Zeichenfolge.
%msa	ULONG64	Adresse einer ANSI_STRING Struktur im virtuellen Adressraum des Prozesses	Die angegebene Zeichenfolge.
%msu	ULONG64	Adresse einer UNICODE_STRING Struktur im virtuellen Adressraum des Prozesses	Die angegebene Zeichenfolge.
%y	ULONG64	Adresse im virtuellen Adressbereich eines Elements mit Symbolinformationen	Zeichenfolge, die den Namen des angegebenen Symbols (und Verschiebung, falls vorhanden) enthält.
%ly	ULONG64	Adresse im virtuellen Adressbereich eines Elements mit Symbolinformationen	Zeichenfolge, die den Namen des angegebenen Symbols (und Verschiebung, falls vorhanden) sowie alle verfügbaren Quellzeileninformationen enthält.

...

Gibt zusätzliche Parameter an, die Werte enthalten, die während der Formatierung in die Ausgabe eingefügt werden sollen.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Beim Generieren sehr großer Ausgabezeichenfolgen ist es möglich, die Grenzen des Debuggermoduls oder des Betriebssystems zu erreichen. Beispielsweise verfügen einige Versionen des Debuggermoduls für eine einzelne Ausgabe über ein 16K-Zeichenlimit. Wenn Sie feststellen, dass eine sehr große Ausgabe abgeschnitten wird, müssen Sie ihre Ausgabe möglicherweise in mehrere Anforderungen aufteilen.