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 emdisplayDetails 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.hBiblioteca: xgameruntime.lib
Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series
