XtfGetTitleOSState

Obtient des informations sur le jeu en cours d’exécution, notamment son état, son ID de processus, le nom complet de son package et ses ID de modèle utilisateur d’application (AUMID).

Syntaxe

HRESULT XtfGetTitleOSState(
        PCWSTR address,
        UINT32* titleStateFlags,
        UINT32* pid,
        PWSTR packageFullName,
        UINT32* packageFullNameLength,
        PWSTR aumid,
        UINT32* aumidLength)

Paramètres

address
Type : PCWSTR [in] Adresse de la console. titleStateFlags
Type : UINT32* [out, optional] Combinaison d’indicateurs (OR au niveau du bit) qui fournissent des informations supplémentaires sur le jeu. Si cette valeur n’est pas nécessaire, définissez-la sur nullptr. Ce paramètre prend en charge les indicateurs suivants :

Indicateur	Valeur	Description
XTF_TITLESTATE_FASTITERATION_ENABLED	0x0001	Le mode d’itération rapide (Fast Iteration Mode) est activé pour ce jeu. Pour plus d’informations sur le mode d’itération rapide, consultez Gestion des applications (xbapp.exe) (rubrique NDA) et Gestion des applications et des fichiers (rubrique NDA).
XTF_TITLESTATE_TITLE_RUNNING	0x0002	Le jeu est en cours d’exécution.
XTF_TITLESTATE_TITLEOS_RUNNING	0x0004	Le Game OS du jeu est en cours d’exécution.
XTF_TITLESTATE_TITLENETWORK_READY	0x0008	La mise en réseau est prête pour le jeu.

pid
Type : UINT32* [out, optional] ID de processus du jeu, si le jeu est en cours d’exécution ; sinon, zéro. Si cette valeur n’est pas nécessaire, définissez-la sur nullptr. packageFullName
Type : PWSTR [out, optional] Nom complet du package du jeu, si le jeu est en cours d’exécution ; sinon, une chaîne vide (""). Si cette valeur n’est pas nécessaire ou si la longueur de la mémoire tampon est requise, définissez-la sur nullptr. packageFullNameLength
Type : UINT32* [out, optional] Longueur de la mémoire tampon requise pour packageFullName, en WCHAR. Si cette valeur n’est pas nécessaire, définissez-la sur nullptr. aumid
Type : PWSTR [out, optional] AUMID du jeu, si le jeu est en cours d’exécution ; sinon, une chaîne vide (""). Si cette valeur n’est pas nécessaire, définissez-la sur nullptr. aumidLength
Type : UINT32* [out, optional] Longueur de la mémoire tampon requise pour aumid, en WCHAR. Si cette valeur n’est pas nécessaire, définissez-la sur nullptr.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur HRESULT. Retourne HRESULT_FROM_WIN32(ERROR_MORE_DATA) si les mémoires tampons packageFullName ou aumid sont trop petites.

Remarques

Cette fonction retourne des informations sur l’état du jeu en cours d’exécution, notamment les indicateurs d’état du titre, l’ID de processus, le nom complet du package et l’ID de modèle utilisateur d’application (AUMID). Pour plus d’informations sur l’empaquetage, consultez Empaquetage. Pour récupérer les longueurs de mémoire tampon requises pour les mémoires tampons packageFullName et aumid, procédez comme suit :

Définissez les paramètres packageFullName et aumid sur nullptr
Définissez les paramètres packageFullNameLength et aumidLength sur des pointeurs UINT32 valides
Appelez XtfGetTitleOSState

Si la fonction s’exécute correctement, les paramètres packageFullNameLength et aumidLength contiennent les longueurs de mémoire tampon requises, en WCHAR, pour packageFullName et aumidLength, respectivement.

Configuration requise

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

Voir aussi

XtfGetAumid
XtfGetPackageFullName
Erreurs de transport XTF (rubrique NDA)
API Xtf supplémentaires

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XtfGetTitleOSState

XtfGetTitleOSState

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Voir aussi

​XtfGetTitleOSState

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Configuration requise

​Voir aussi

XtfGetTitleOSState

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Voir aussi