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

Obtiene información sobre el juego en ejecución, incluido su estado, identificador de proceso, nombre completo de paquete e identificadores de modelo de usuario de aplicación (AUMID).

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*address*\
Tipo: PCWSTR

\[in] La dirección de la consola.

*titleStateFlags*\
Tipo: UINT32\*

\[out, optional] Una combinación OR bit a bit de marcas que proporcionan información adicional sobre el juego. Si este valor no es necesario, establézcalo en `nullptr`. Este parámetro admite las siguientes marcas:

| Marca                                | Valor                                   | Descripción                                             |                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------ | --------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 


                                  | XTF\_TITLESTATE\_FASTITERATION\_ENABLED | 0x0001                                                  | El modo de iteración rápida está habilitado para este juego. Para obtener más información sobre el modo de iteración rápida, consulte [Administración de aplicaciones (xbapp.exe) (tema con NDA)](/tools/tools-console/commandlinetools/xbapp) y [Administración de aplicaciones y archivos (tema con NDA)](/tools/tools-console/xbom/manager-tool-managing-applications). |
| XTF\_TITLESTATE\_TITLE\_RUNNING      | 0x0002                                  | El juego está en ejecución en este momento.             |                                                                                                                                                                                                                                                                                                                                                                            |
| XTF\_TITLESTATE\_TITLEOS\_RUNNING    | 0x0004                                  | El Game OS del juego está en ejecución en este momento. |                                                                                                                                                                                                                                                                                                                                                                            |
| XTF\_TITLESTATE\_TITLENETWORK\_READY | 0x0008                                  | Las redes están listas para el juego.                   |                                                                                                                                                                                                                                                                                                                                                                            |

*pid*\
Tipo: UINT32\*

\[out, optional] El identificador de proceso del juego, si el juego está en ejecución en ese momento; de lo contrario, cero. Si este valor no es necesario, establézcalo en `nullptr`.

*packageFullName*\
Tipo: PWSTR

\[out, optional] El nombre completo del paquete del juego, si el juego está en ejecución en ese momento; de lo contrario, una cadena vacía (""). Si este valor no es necesario o si se necesita la longitud del búfer, establézcalo en `nullptr`.

*packageFullNameLength*\
Tipo: UINT32\*

\[out, optional] La longitud del búfer necesaria para *packageFullName* en WCHAR. Si este valor no es necesario, establézcalo en `nullptr`.

*aumid*\
Tipo: PWSTR

\[out, optional] El AUMID del juego, si el juego está en ejecución en ese momento; de lo contrario, una cadena vacía (""). Si este valor no es necesario, establézcalo en `nullptr`.

*aumidLength*\
Tipo: UINT32\*

\[out, optional] La longitud del búfer necesaria para *aumid* en WCHAR. Si este valor no es necesario, establézcalo en `nullptr`.

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT. Devuelve `HRESULT_FROM_WIN32(ERROR_MORE_DATA)` si los búferes de `packageFullName` o `aumid` son demasiado pequeños.

<a id="remarksSection" />

## Comentarios

Esta función devuelve información sobre el estado del juego actualmente en ejecución, incluidas las marcas de estado del título, el identificador de proceso, el nombre completo del paquete y el identificador de modelo de usuario de aplicación (AUMID). Para obtener más información sobre el empaquetado, consulte [Empaquetado](/build/core-features/common/packaging/gc-packaging-toc).

Para recuperar las longitudes de búfer necesarias para los búferes `packageFullName` y `aumid`, realice los pasos siguientes:

1. Establezca los parámetros `packageFullName` y `aumid` en `nullptr`
2. Establezca los parámetros `packageFullNameLength` y `aumidLength` en punteros UINT32 válidos
3. Llame a `XtfGetTitleOSState`

Si la función se ejecuta correctamente, los parámetros `packageFullNameLength` y `aumidLength` contienen las longitudes de búfer necesarias, en WCHAR, para `packageFullName` y `aumidLength`, respectivamente.

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

**Plataformas compatibles:** Windows (para las herramientas de consola XBOX)

<a id="seealsoSection" />

## Consulte también

[XtfGetAumid](/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m)\
[XtfGetPackageFullName](/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m)\
[Errores de transporte de XTF (tema con NDA)](/tools/tools-console/commandlinetools/xtf-transport-errors)\
[API de Xtf adicionales](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfGetCachedTitleOSVersions](/es/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](/es/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](/es/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [XtfGetTitleProcessMemoryReports](/es/reference/tools/xtf/xtfapi/functions/xtfgettitleprocessmemoryreports-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOS](/es/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)