Skip to main content

XGameStreamingGetAssociatedFrame

Preterido. Esta API foi preterida a partir da versão 2604 do GDK e será removida em uma versão futura do GDK. Não há API substituta: os títulos devem usar XGameStreamingGetStreamAddedLatency para ajustes de jogabilidade com reconhecimento de latência.
Obtém o token de pipeline de quadros de uma leitura de entrada específica.

Sintaxe

Parâmetros

gamepadReading   _In_
Tipo: IGameInputReading*
A leitura do gamepad que está sendo consultada. framePipelineToken   _Out_
Tipo: D3D12XBOX_FRAME_PIPELINE_TOKEN*
O token de pipeline de quadros associado ao quadro exibido no dispositivo do cliente quando a entrada foi feita pelo jogador. Esse token de pipeline corresponde à chamada de PresentX quando o quadro foi apresentado pelo jogo e enviado ao dispositivo cliente.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedido; caso contrário, retorna um código de erro.

Possíveis erros

Comentários

Quando um jogador está fazendo streaming de um jogo, XGameStreamingGetAssociatedFrame pode ser utilizado se o jogo precisar alterar seu comportamento com base no quadro específico exibido no dispositivo do jogador quando a entrada foi feita. Isso permite que o jogo tome suas decisões de simulação com base no quadro que o jogador viu no momento da entrada, e não no quadro atual. XGameStreamingGetAssociatedFrame só pode fornecer ao jogo informações sobre o quadro exibido quando uma nova leitura de entrada é criada. Caso o jogo precise determinar o que estava sendo exibido quando uma entrada pode não ter sido feita pelo jogador, o jogo deve utilizar XGameStreamingGetLastFrameDisplayed.

Exemplo

Requisitos

Cabeçalho: xgamestreaming.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XGameStreamingGetLastFrameDisplayed
XGameStreaming
Visão geral da compensação de latência do streaming de jogos
Last modified on October 6, 2026