> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfGetTitleOSState

> XtfGetTitleOSState

# 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).

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XtfGetTitleOSState(
        PCWSTR address,
        UINT32* titleStateFlags,
        UINT32* pid,
        PWSTR packageFullName,
        UINT32* packageFullNameLength,
        PWSTR aumid,
        UINT32* aumidLength)
```

<a id="parametersSection" />

### 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)](/fr/tools/tools-console/commandlinetools/xbapp) et [Gestion des applications et des fichiers (rubrique NDA)](/fr/tools/tools-console/xbom/manager-tool-managing-applications). |
| 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`.

<a id="retvalSection" />

### 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.

<a id="remarksSection" />

## 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](/fr/build/core-features/common/packaging/gc-packaging-toc).

Pour récupérer les longueurs de mémoire tampon requises pour les mémoires tampons `packageFullName` et `aumid`, procédez comme suit :

1. Définissez les paramètres `packageFullName` et `aumid` sur `nullptr`
2. Définissez les paramètres `packageFullNameLength` et `aumidLength` sur des pointeurs UINT32 valides
3. 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.

<a id="requirementsSection" />

## Configuration requise

**En-tête :** xtfapi.h

**Bibliothèque :** XtfApi.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

<a id="seealsoSection" />

## Voir aussi

[XtfGetAumid](/fr/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m)\
[XtfGetPackageFullName](/fr/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m)\
[Erreurs de transport XTF (rubrique NDA)](/fr/tools/tools-console/commandlinetools/xtf-transport-errors)\
[API Xtf supplémentaires](/fr/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfGetTitleOSState](/reference/tools/xtf/xtfapi/functions/xtfgettitleosstate-xtfapi-xbox-windows-m.md)
- [XtfWaitForConsoleState](/reference/tools/xtf/xtfapi/functions/xtfwaitforconsolestate.md)
- [XtfGetCachedTitleOSVersions](/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)