Metodo IDebugControl2::OutputVaList (dbgeng.h)
Il metodo OutputVaList formatta una stringa e invia il risultato ai callback di output registrati con i client del motore.
Sintassi
HRESULT OutputVaList(
[in] ULONG Mask,
[in] PCSTR Format,
[in] va_list Args
);
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 genere, i caratteri di conversione funzionano esattamente come funzionano 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. Potrebbe non 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 indirizzi virtuale 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 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. |
[in] Args
Specifica parametri aggiuntivi che rappresentano i valori da inserire nell'output durante la formattazione. Gli argomenti devono essere inizializzati usando va_start. Questo metodo non chiama va_end.
Valore restituito
Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere Valori restituiti .
Codice restituito | Descrizione |
---|---|
|
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.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | dbgeng.h (include Dbgeng.h, Stdarg.h) |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per