Skip to main content

XtfGetConsoleInfoList

Retourne un objet XtfConsoleInfo qui contient des informations sur une console.

Syntaxe

Paramètres

address
Type : PCWSTR
[in] Adresse de la console. hConsoleInfo
Type : XtfConsoleInfo*
[out] Pointeur à utiliser avec la fonction XtfGetConsoleFieldValue pour récupérer des informations sur une console.

Valeur de retour

Type : HRESULT Retourne S_OK si la fonction a réussi et que XtfGetConsoleFieldValue peut être utilisée pour récupérer des valeurs à partir de hConsoleInfo ; sinon, retourne un code d’erreur HRESULT.

Remarques

Pour récupérer des informations sur une console, utilisez d’abord cette fonction pour obtenir un pointeur XtfConsoleInfo, puis utilisez XtfGetConsoleFieldValue pour récupérer des informations sur la console à partir de ce pointeur. Après avoir récupéré les informations dont vous avez besoin, utilisez XtfCloseConsoleInfoList pour libérer les ressources associées au pointeur XtfConsoleInfo retourné.
XtfGetConsoleInfoList récupère toutes les informations de la console et fournit un pointeur vers ces informations. XtfGetConsoleFieldValue se contente de parcourir ces informations récupérées. Vous devez utiliser les deux fonctions ensemble pour récupérer des informations sur une console.
Si la console cible spécifiée dans address pour cette fonction n’a pas été provisionnée, la fonction XtfGetConsoleFieldValue retourne une valeur vide si XtfConsoleFieldId::DeviceID est spécifié dans field.
L’exemple de code suivant montre comment utiliser conjointement les fonctions XtfGetConsoleInfoList et XtfGetConsoleFieldValue pour récupérer l’ID de console d’une console de développement.

Configuration requise

En-tête : xtfapi.h Bibliothèque : XtfApi.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)

Voir aussi

XtfConsoleControl
XBOX Tools Framework
Last modified on October 6, 2026