Partager via


Méthode IDebugControl4 ::OutputPromptWide (dbgeng.h)

La méthode OutputPromptWide met en forme et envoie une invite utilisateur aux objets de rappel de sortie.

Syntaxe

HRESULT OutputPromptWide(
  [in]           ULONG  OutputControl,
  [in, optional] PCWSTR Format,
                 ...    
);

Paramètres

[in] OutputControl

Spécifie un contrôle de sortie qui détermine quels rappels de sortie du client recevront la sortie. Pour connaître les valeurs possibles, consultez DEBUG_OUTCTL_XXX.

[in, optional] Format

Spécifie la chaîne de format, comme dans printf. En règle générale, les caractères de conversion fonctionnent exactement comme dans C. Pour les caractères de conversion à virgule flottante, l’argument 64 bits est interprété comme un nombre à virgule flottante 32 bits, sauf si le modificateur l est utilisé.

Le caractère de conversion %p est pris en charge, mais il représente un pointeur dans l’espace d’adressage d’une cible. Il n’a peut-être pas de modificateurs et utilise la mise en forme d’adresse interne du débogueur. Les caractères de conversion supplémentaires suivants sont pris en charge.

Caractère Type d’argument Argument Texte imprimé
%p ULONG64 Pointeur dans un espace d’adressage. Valeur du pointeur.
%N DWORD_PTR (32 ou 64 bits, selon l’architecture de l’hôte) Pointeur dans l’espace d’adressage virtuel de l’hôte. Valeur du pointeur. (Cela équivaut au caractère C %p standard.)
%I ULONG64 Toute valeur 64 bits. Valeur spécifiée. Si cette valeur est supérieure à 0xFFFFFFFF, elle est imprimée sous la forme d’une valeur 64 bits ; sinon, elle est imprimée sous la forme d’une valeur 32 bits.
%ma ULONG64 Adresse d’une chaîne ASCII terminée par NULL dans l’espace d’adressage virtuel du processus. Chaîne spécifiée.
%mu ULONG64 Adresse d’une chaîne Unicode terminée par NULL dans l’espace d’adressage virtuel du processus. Chaîne spécifiée.
%msa ULONG64 Adresse d’une structure ANSI_STRING dans l’espace d’adressage virtuel du processus. Chaîne spécifiée.
%msu ULONG64 Adresse d’une structure UNICODE_STRING dans l’espace d’adressage virtuel du processus. Chaîne spécifiée.
%y ULONG64 Adresse dans l’espace d’adressage virtuel du processus d’un élément avec des informations de symbole. Chaîne qui contient le nom du symbole spécifié (et le déplacement, le cas échéant).
%ly ULONG64 Adresse dans l’espace d’adressage virtuel du processus d’un élément avec des informations de symbole. Chaîne qui contient le nom du symbole spécifié (et le déplacement, le cas échéant), ainsi que les informations de ligne source disponibles.
 

Si Format a la valeur NULL, seul le texte d’invite standard est envoyé aux rappels de sortie.

...

Spécifie des paramètres supplémentaires qui représentent des valeurs à insérer dans la sortie pendant la mise en forme.

Valeur retournée

Code de retour Description
S_OK
La méthode a réussi.
 

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Remarques

OutputPrompt et OutputPromptWide peuvent être utilisés pour inviter l’utilisateur à entrer une entrée.

L’invite standard est envoyée aux rappels de sortie avant le texte mis en forme décrit par Format. Le contenu de l’invite standard est retourné par la méthode GetPromptText.

Le texte de l’invite est envoyé aux rappels de sortie avec le masque de sortie DEBUG_OUTPUT_PROMPT défini.

Pour plus d’informations sur l’invite à l’utilisateur, consultez Utilisation de l’entrée et de la sortie.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)

Voir aussi

ControlledOutput

DEBUG_OUTPUT_XXX

GetPromptText

IDebugControl4

OutputPromptVaList