Skip to main content

​
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

​
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: 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. 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
XtfGetPackageFullName
Errores de transporte de XTF (tema con NDA)
API de Xtf adicionales
Última modificación el 28 de agosto de 2026

Temas relacionados

XtfGetCachedTitleOSVersionsXtfGetTitleOSFourPartVersionXtfGetCachedTitleOSVersionsCallbackXtfGetTitleProcessMemoryReportsXtfStartTitleOS