Skip to main content

XGameStreamingGetDisplayDetails

Esta API retorna os detalhes de exibição do cliente especificado. Isso pode ser usado para tomar decisões informadas, como em quais proporções personalizadas renderizar ou qual resolução usar para habilitar o DirectCapture.

Sintaxe

Parâmetros

client   _In_
Tipo: XGameStreamingClientId
O cliente de streaming que está sendo consultado. maxSupportedPixels   _In_
Tipo: uint32_t
O número máximo de pixels com suporte no jogo. widestSupportedAspectRatio   _In_
Tipo: float
A proporção mais larga com suporte no jogo. Ela é calculada a partir de largura / altura usando a resolução mais larga com suporte. tallestSupportedAspectRatio   _In_
Tipo: float
A proporção mais alta com suporte no jogo. Ela é calculada a partir de largura / altura usando a resolução mais alta com suporte. displayDetails   _Out_
Tipo: XGameStreamingDisplayDetails*
Os detalhes de exibição do cliente de streaming.

Valor retornado

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

Erros potenciais

Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

Os dados em displayDetails podem ser usados para orientar aspectos do jogo, como a resolução na qual renderizar o jogo, e para informar onde posicionar informações ou interface do usuário críticas, garantindo que sejam interativas e não fiquem obstruídas. Os campos preferredWidth e preferredHeight no struct displayDetails se baseiam na tela real do cliente de streaming, nas limitações do sistema de streaming e nos parâmetros fornecidos pelo jogo (maxSupportedPixels, widestSupportedAspectRatio, tallestSupportedAspectRatio). Lembre-se de que os dados podem não estar disponíveis na inicialização do jogo e não necessariamente estarão disponíveis no momento do evento de conexão do cliente; portanto, os jogos devem usar eventos ou sondagem.

Exemplo

Requisitos

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

Confira também

XGameStreaming XGameStreamingDisplayDetails XGameStreamingRegisterClientPropertiesChanged XGameStreamingSetResolution Visão geral da resolução personalizada
Last modified on October 6, 2026