XGameStreamingGetDisplayDetails
Esta API devuelve los detalles de pantalla del cliente especificado. Se puede usar para tomar decisiones fundamentadas, como con qué relaciones de aspecto personalizadas representar o qué resolución usar para habilitar DirectCapture.Sintaxis
Parámetros
client _In_Tipo: XGameStreamingClientId El cliente de streaming que se está consultando. maxSupportedPixels _In_
Tipo: uint32_t El número máximo de píxeles que admite el juego. widestSupportedAspectRatio _In_
Tipo: float La relación de aspecto más ancha que admite el juego. Se calcula a partir de ancho / alto usando la resolución más ancha admitida. tallestSupportedAspectRatio _In_
Tipo: float La relación de aspecto más alta que admite el juego. Se calcula a partir de ancho / alto usando la resolución más alta admitida. displayDetails _Out_
Tipo: XGameStreamingDisplayDetails* Los detalles de pantalla del cliente de streaming.
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
Los datos incluidos endisplayDetails se pueden usar para controlar aspectos del juego, como la resolución a la que se representa el juego, y para determinar dónde colocar información crítica o la interfaz de usuario a fin de garantizar que sea interactiva y no quede oculta.
Los valores preferredWidth y preferredHeight de la estructura displayDetails se basan en la pantalla real del cliente de streaming, en las limitaciones del sistema de streaming y en los parámetros proporcionados por el juego (maxSupportedPixels, widestSupportedAspectRatio, tallestSupportedAspectRatio).
Tenga en cuenta que es posible que los datos no estén disponibles al iniciar el juego y que no necesariamente estén disponibles en el momento del evento de conexión del cliente, por lo que los juegos deben usar eventos o sondeo.
Ejemplo
Requisitos
Encabezado: xgamestreaming.hBiblioteca: xgameruntime.lib
Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series
