XtfGetTitleOSState

Obtém informações sobre o jogo em execução, incluindo seu estado, ID do processo, nome completo do pacote e AUMIDs (Application User Model IDs).

Sintaxe

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

Parâmetros

address
Tipo: PCWSTR [in] O endereço do console. titleStateFlags
Tipo: UINT32* [out, optional] Uma combinação OR bit a bit de sinalizadores que fornecem informações adicionais sobre o jogo. Se esse valor não for necessário, defina-o como nullptr. Esse parâmetro dá suporte aos seguintes sinalizadores:

Sinalizador	Valor	Descrição
XTF_TITLESTATE_FASTITERATION_ENABLED	0x0001	O Modo de Iteração Rápida está habilitado para esse jogo. Para obter mais informações sobre o Modo de Iteração Rápida, confira Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA) e Gerenciamento de aplicativos e arquivos (tópico sob NDA).
XTF_TITLESTATE_TITLE_RUNNING	0x0002	O jogo está em execução no momento.
XTF_TITLESTATE_TITLEOS_RUNNING	0x0004	O Game OS do jogo está em execução no momento.
XTF_TITLESTATE_TITLENETWORK_READY	0x0008	A rede está pronta para o jogo.

pid
Tipo: UINT32* [out, optional] O ID do processo do jogo, se o jogo estiver em execução no momento; caso contrário, zero. Se esse valor não for necessário, defina-o como nullptr. packageFullName
Tipo: PWSTR [out, optional] O nome completo do pacote do jogo, se o jogo estiver em execução no momento; caso contrário, uma cadeia de caracteres vazia (""). Se esse valor não for necessário ou se o comprimento do buffer for necessário, defina-o como nullptr. packageFullNameLength
Tipo: UINT32* [out, optional] O comprimento do buffer necessário para packageFullName em WCHAR. Se esse valor não for necessário, defina-o como nullptr. aumid
Tipo: PWSTR [out, optional] A AUMID do jogo, se o jogo estiver em execução no momento; caso contrário, uma cadeia de caracteres vazia (""). Se esse valor não for necessário, defina-o como nullptr. aumidLength
Tipo: UINT32* [out, optional] O comprimento do buffer necessário para aumid em WCHAR. Se esse valor não for necessário, defina-o como nullptr.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedido; caso contrário, retorna um código de erro HRESULT. Retorna HRESULT_FROM_WIN32(ERROR_MORE_DATA) se os buffers packageFullName ou aumid forem muito pequenos.

Comentários

Essa função retorna informações sobre o estado do jogo em execução no momento, incluindo sinalizadores de estado do título, ID do processo, nome completo do pacote e AUMID (Application User Model ID). Para obter mais informações sobre empacotamento, confira Empacotamento. Para recuperar os comprimentos de buffer necessários para os buffers packageFullName e aumid, execute as seguintes etapas:

Defina os parâmetros packageFullName e aumid como nullptr
Defina os parâmetros packageFullNameLength e aumidLength como ponteiros UINT32 válidos
Chame XtfGetTitleOSState

Se a função for executada com êxito, os parâmetros packageFullNameLength e aumidLength conterão os comprimentos de buffer necessários, em WCHAR, para packageFullName e aumidLength, respectivamente.

Requisitos

Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

XtfGetAumid
XtfGetPackageFullName
Erros de transporte do XTF (tópico sob NDA)
APIs adicionais do Xtf

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XtfGetTitleOSState

XtfGetTitleOSState

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também

​XtfGetTitleOSState

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Requisitos

​Confira também

XtfGetTitleOSState

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também