> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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).

## Sintaxis

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

### 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)](https://docs.xbox.com/es/tools/tools-console/commandlinetools/xbapp.md) y [Administración de aplicaciones y archivos (tema con NDA)](https://docs.xbox.com/es/tools/tools-console/xbom/manager-tool-managing-applications.md). |
| 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`.

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

## 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](https://docs.xbox.com/es/build/core-features/common/packaging/gc-packaging-toc.md).

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.

## Requisitos

**Encabezado:** xtfapi.h

**Biblioteca:** XtfApi.lib

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

## Consulte también

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


## Related topics

- [API de Xtf adicionales (contenido de la API)](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfGetCachedTitleOSVersions](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md)
- [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfGetTitleProcessMemoryReports](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgettitleprocessmemoryreports-xtfapi-xbox-windows-m.md)