Skip to main content

XGameStreamingSetResolution

Define a resolução do stream.

Sintaxe

Parâmetros

width   _In_
Tipo: uint32_t
A largura para a qual definir a resolução do stream. height   _In_
Tipo: uint32_t
A altura para a qual definir a resolução do stream.

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

Esta API com resoluções não padrão só terá êxito em servidores do XBOX Game Streaming, no XBOX Series X Dev Kit e no XBOX Series S Test Kit. Resoluções padrão, como 720p e 1080p, terão êxito independentemente do hardware. O motivo é que um XBOX de varejo só pode fazer streaming por meio do Remote Play e ainda pode estar enviando vídeo para a TV, portanto, usar uma resolução não padrão produziria uma imagem distorcida. A largura e a altura devem ser de no mínimo 640x360, e o máximo pode ser encontrado nos campos maxWidth e maxHeight de XGameStreamingDisplayDetails, que pode ser obtido de XGameStreamingGetDisplayDetails. O número máximo de pixels, calculado por width * height, deve ser igual ou menor que o máximo do codificador. O máximo pode ser encontrado usando a API XGameStreamingGetDisplayDetails. Esse valor poderá ser aumentado no futuro. Os valores de width e height devem ser divisíveis por 8. A API pode ser chamada com a frequência desejada; no entanto, a resolução do stream só pode mudar uma vez a cada 200 ms. A última resolução de quaisquer chamadas que ocorrerem dentro dessa janela de 200 ms será aplicada após o término dessa janela. Esteja ciente de que esta API definirá a resolução do stream para todos os clientes conectados. Isso significa que é preciso ter uma consideração especial para determinar qual é a melhor opção para o jogo quando vários clientes estiverem conectados. Isso pode significar usar uma resolução padrão 16:9 ou tentar encontrar a resolução que melhor se ajuste a todos os clientes.
Alterar a resolução do stream modifica o dimensionamento do retângulo de exibição em ID3D12CommandQueue::PresentX. Os fatores de escala de 0.0 a 1.0 de D3D12XBOX_PRESENT_PLANE_PARAMETERS.pDestPlacementBase referem-se à altura e à largura passadas para XGameStreamingSetResolution, em vez da resolução padrão de 1920x1080 ou 3840x2160 à qual se refeririam de outra forma.

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
XGameStreamingGetDisplayDetails
Visão geral da resolução personalizada
Last modified on October 6, 2026