IDebugControl::OutputVaList-Methode (dbgeng.h)

Artikel
02/23/2024

Die OutputVaList-Methode formatiert eine Zeichenfolge und sendet das Ergebnis an die Ausgaberückrufe , die bei den Clients der Engine registriert sind.

Syntax

HRESULT OutputVaList(
  [in] ULONG   Mask,
  [in] PCSTR   Format,
  [in] va_list Args
);

Parameter

[in] Mask

Gibt das Ausgabetyp-Bitfeld an. Mögliche Werte finden Sie unter DEBUG_OUTPUT_XXX .

[in] Format

Gibt die Formatzeichenfolge an, wie in printf. In der Regel 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 aber einen Zeiger im Adressraum eines Ziels dar. Es verfügt möglicherweise über keine Modifizierer 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 standardmäßigen C %p-Zeichen .)
%I	ULONG64	Ein 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 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 Adressraum des Prozesses eines Elements mit Symbolinformationen.	Zeichenfolge, die den Namen des angegebenen Symbols (und ggf. Verschiebung) enthält.
%ly	ULONG64	Adresse im virtuellen Adressraum des Prozesses eines Elements mit Symbolinformationen.	Zeichenfolge, die den Namen des angegebenen Symbols (und ggf. Verschiebung) sowie alle verfügbaren Quellzeileninformationen enthält.

[in] Args

Gibt zusätzliche Parameter an, die Werte darstellen, die während der Formatierung in die Ausgabe eingefügt werden sollen. Args müssen mit va_start initialisiert werden. Diese Methode ruft va_end nicht auf.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. 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 eine Zeichenbeschränkung von 16 KB für eine einzelne Ausgabe auf. Wenn Sie feststellen, dass sehr große Ausgaben abgeschnitten werden, müssen Sie die Ausgabe möglicherweise in mehrere Anforderungen aufteilen.