Metodo IDebugControl2::OutputPrompt (dbgeng.h)

Articolo
02/25/2024

Il metodo OutputPrompt formatta e invia un prompt utente agli oggetti di callback di output.

Sintassi

HRESULT OutputPrompt(
  [in]           ULONG OutputControl,
  [in, optional] PCSTR Format,
                 ...   
);

Parametri

[in] OutputControl

Specifica un controllo di output che determina quale callback di output del client riceverà l'output. Per i valori possibili, vedere DEBUG_OUTCTL_XXX.

[in, optional] Format

Specifica la stringa di formato, come in printf. In genere, i caratteri di conversione funzionano esattamente come fanno 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 seguenti caratteri di conversione aggiuntivi.

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. Equivalente 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 virtuale 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 lo 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é le informazioni sulla riga di origine disponibili.

Se Format è NULL, viene inviato solo il testo del prompt standard ai callback di output.

...

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

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Commenti

OutputPrompt e OutputPromptWide possono essere usati per richiedere all'utente l'input.

Il prompt standard verrà inviato ai callback di output prima del testo formattato descritto in Formato. Il contenuto del prompt standard viene restituito dal metodo GetPromptText.

Il testo del prompt viene inviato ai callback di output con il set di maschera di output DEBUG_OUTPUT_PROMPT .

Per altre informazioni sulla richiesta dell'utente, vedere Uso dell'input e dell'output.