Freigeben über


IDebugControl2::Output-Methode (dbgeng.h)

Die Output-Methode formatiert eine Zeichenfolge und sendet das Ergebnis an die Ausgabe von Rückrufen, die bei den Clients des Moduls registriert wurden.

Syntax

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

Parameter

[in] Mask

Gibt das Ausgabetypbitfeld an. Mögliche Werte finden Sie unter DEBUG_OUTPUT_XXX .

[in] Format

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

Das Konvertierungszeichen %p wird unterstützt, stellt aber einen Zeiger im Adressraum eines Ziels dar. Es kann keine Modifizierer haben und verwendet die interne Adressformatierung des Debuggers. 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 Bits, abhängig von der Architektur des Hosts) Zeiger im virtuellen Adressraum des Hosts Der Wert des Zeigers. (Dies entspricht dem C %p-Standardzeichen .)
%I ULONG64 Beliebiger 64-Bit-Wert Der angegebene Wert. Wenn dieser größer als 0xFFFFFFFF ist, wird er als 64-Bit-Wert gedruckt. Andernfalls wird er als 32-Bit-Wert ausgegeben.
%ma ULONG64 Adresse einer 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 Adressraum eines Elements mit Symbolinformationen Zeichenfolge, die den Namen des angegebenen Symbols (und ggf. Verschiebung) enthält.
%ly ULONG64 Adresse im virtuellen Adressraum eines Elements mit Symbolinformationen Zeichenfolge, die den Namen des angegebenen Symbols (und ggf. Verschiebung) 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.

Hinweise

Beim Generieren sehr großer Ausgabezeichenfolgen ist es möglich, die Grenzen der Debugger-Engine oder des Betriebssystems zu erreichen. Beispielsweise weisen einige Versionen der Debugger-Engine ein Zeichenlimit von 16 KB für eine einzelne Ausgabe auf. Wenn Sie feststellen, dass sehr große Ausgaben abgeschnitten werden, müssen Sie Ihre Ausgabe möglicherweise in mehrere Anforderungen aufteilen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)

Weitere Informationen

.Printf

ControlledOutput

IDebugControl

IDebugControl2

IDebugControl3

OutputVaList

dprintf