Metodo IDebugControl2::Output (dbgeng.h)

Articolo
08/07/2023

Il metodo Output formatta una stringa e invia il risultato ai callback di output registrati con i client del motore.

Sintassi

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

Parametri

[in] Mask

Specifica il campo di bit del tipo di output. Per i valori possibili, vedere DEBUG_OUTPUT_XXX.

[in] Format

Specifica la stringa di formato, come in printf. In generale, i caratteri di conversione funzionano esattamente come in C. Per i caratteri di conversione a virgola mobile, l'argomento a 64 bit viene interpretato come numero a virgola mobile a 32 bit, a meno che non venga usato il modificatore l .

Il carattere di conversione %p è supportato, ma rappresenta un puntatore nello spazio indirizzi di una destinazione. Non può avere modificatori e usa la formattazione degli indirizzi interni del debugger. Sono supportati i caratteri di conversione aggiuntivi seguenti.

Carattere	Tipo di argomento	Argomento	Testo stampato
%p	ULONG64	Puntatore in uno spazio indirizzi	Valore del puntatore.
%N	DWORD_PTR (32 o 64 bit, a seconda dell'architettura dell'host)	Puntatore nello spazio indirizzi virtuale dell'host	Valore del puntatore. Equivale al carattere C %p standard.
%I	ULONG64	Qualsiasi valore a 64 bit	Valore specificato. Se è maggiore di 0xFFFFFFFF, viene stampato come valore a 64 bit. In caso contrario, viene stampato come valore a 32 bit.
%ma	ULONG64	Indirizzo di una stringa ASCII con terminazione NULL nello spazio degli indirizzi virtuali del processo	Stringa specificata
%mu	ULONG64	Indirizzo di una stringa Unicode con terminazione NULL nello spazio indirizzi virtuali del processo	Stringa specificata
%msa	ULONG64	Indirizzo di una struttura di ANSI_STRING nello spazio indirizzi virtuale del processo	Stringa specificata
%msu	ULONG64	Indirizzo di una struttura di UNICODE_STRING nello spazio indirizzi virtuale del processo	Stringa specificata
%y	ULONG64	Indirizzo nello spazio indirizzi virtuale del processo di un elemento con informazioni sui simboli	Stringa contenente il nome del simbolo specificato (e spostamento, se presente).
%ly	ULONG64	Indirizzo nello spazio indirizzi virtuale del processo di un elemento con informazioni sui simboli	Stringa contenente il nome del simbolo specificato (e lo spostamento, se presente), nonché eventuali informazioni sulla riga di origine disponibili.

...

Specifica parametri aggiuntivi che contengono valori da inserire nell'output durante la formattazione.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Quando si generano stringhe di output molto grandi, è possibile raggiungere i limiti del motore del debugger o del sistema operativo. Ad esempio, alcune versioni del motore del debugger hanno un limite di 16.000 caratteri per un singolo output. Se si rileva che l'output di grandi dimensioni viene troncato, potrebbe essere necessario suddividere l'output in più richieste.