XGameStreamingSetResolution
Establece la resolución de la transmisión.Sintaxis
Parámetros
width _In_Tipo: uint32_t El ancho en el que se establecerá la resolución de la transmisión. height _In_
Tipo: uint32_t El alto en el que se establecerá la resolución de la transmisión.
Valor devuelto
Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error.Posibles errores
Para obtener una lista de códigos de error, consulte Códigos de error.
Comentarios
Esta API con resoluciones no estándar solo se ejecutará correctamente en servidores de XBOX Game Streaming, en el kit de desarrollo XBOX Series X y en el kit de pruebas XBOX Series S. Las resoluciones estándar como 720p y 1080p se ejecutarán correctamente independientemente del hardware. El motivo es que una XBOX comercial solo puede transmitir mediante Remote Play y es posible que siga emitiendo vídeo al televisor, por lo que usar una resolución no estándar produciría una imagen distorsionada. El ancho y el alto deben ser como mínimo de 640x360, y el máximo se puede encontrar en los camposmaxWidth y maxHeight de XGameStreamingDisplayDetails, que se puede recuperar desde XGameStreamingGetDisplayDetails.
Los píxeles máximos, calculados a partir de width * height, deben ser iguales o inferiores al máximo del codificador. El máximo se puede encontrar mediante la API XGameStreamingGetDisplayDetails. Este valor puede aumentar en el futuro.
width y height deben ser divisibles por 8.
Se puede llamar a la API con la frecuencia que se desee; sin embargo, la resolución de la transmisión solo puede cambiar una vez cada 200 ms. La última resolución de todas las llamadas que se produzcan dentro de esa ventana de 200 ms se aplicará una vez transcurrida dicha ventana.
Tenga en cuenta que esta API establecerá la resolución de la transmisión para todos los clientes conectados. Esto significa que se debe prestar especial atención para determinar cuál es la mejor opción para el juego cuando hay varios clientes conectados. Puede significar usar una resolución estándar de 16:9 o puede significar intentar encontrar la resolución que mejor se adapte a todos los clientes.
Cambiar la resolución de la transmisión modifica el escalado del rectángulo de vista en ID3D12CommandQueue::PresentX. Los factores de escala de 0.0 a 1.0 de D3D12XBOX_PRESENT_PLANE_PARAMETERS.pDestPlacementBase se refieren al alto y al ancho pasados a XGameStreamingSetResolution, en lugar de a la resolución estándar de 1920x1080 o 3840x2160 a la que se referirían en caso contrario.
Ejemplo
Requisitos
Encabezado: xgamestreaming.hBiblioteca: xgameruntime.lib
Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series
Consulte también
XGameStreamingXGameStreamingDisplayDetails
XGameStreamingGetDisplayDetails
Información general sobre resolución personalizada
