Skip to main content

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 en displayDetails 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.h
Biblioteca: xgameruntime.lib
Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

XGameStreaming XGameStreamingDisplayDetails XGameStreamingRegisterClientPropertiesChanged XGameStreamingSetResolution Información general sobre la resolución personalizada
Última modificación el 28 de agosto de 2026