> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # XGameStreamingGetDisplayDetails > XGameStreamingGetDisplayDetails # XGameStreamingGetDisplayDetails Cette API retourne les détails d'affichage du client spécifié. Ils peuvent servir à prendre des décisions éclairées, par exemple sur les rapports d'aspect personnalisés à utiliser pour le rendu ou sur la résolution à utiliser pour activer DirectCapture. ## Syntaxe ```cpp theme={null} HRESULT XGameStreamingGetDisplayDetails( XGameStreamingClientId client, uint32_t maxSupportedPixels, float widestSupportedAspectRatio, float tallestSupportedAspectRatio, XGameStreamingDisplayDetails* displayDetails ) ``` ### Paramètres *client*   \_In\_\ Type : XGameStreamingClientId Client de diffusion en continu interrogé. *maxSupportedPixels*   \_In\_\ Type : uint32\_t Nombre maximal de pixels pris en charge par le jeu. *widestSupportedAspectRatio*   \_In\_\ Type : float Rapport d'aspect le plus large pris en charge par le jeu. Il est calculé selon largeur / hauteur à partir de la résolution la plus large prise en charge. *tallestSupportedAspectRatio*   \_In\_\ Type : float Rapport d'aspect le plus haut pris en charge par le jeu. Il est calculé selon largeur / hauteur à partir de la résolution la plus haute prise en charge. *displayDetails*   \_Out\_\ Type : [XGameStreamingDisplayDetails\*](/fr-CA/reference/system/xgamestreaming/structs/xgamestreamingdisplaydetails) Détails d'affichage du client de diffusion en continu. ### Valeur de retour Type : HRESULT Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur. #### Erreurs potentielles | Code d'erreur | Valeur d'erreur | Cause de l'erreur | | - | - | - | | E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | Le runtime XGameStreaming n'a pas été initialisé. Appelez XGameStreamingInitialize avant d'appeler d'autres API. | | E\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED | 0x89245401 | Le client spécifié n'est pas connecté. | | E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | Les données demandées ne sont pas disponibles. Elles pourraient l'être plus tard. | | E\_INVALIDARG | 0x80070057 | Un ou plusieurs paramètres ne sont pas valides. `maxSupportedPixels` doit être supérieur à 0. `widestSupportedAspectRatio` doit être supérieur ou égal à 16/9 et ne doit pas être infini. `tallestSupportedAspectRatio` doit être inférieur ou égal à 16/9 et doit être supérieur à 0. | Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes). ## Remarques Les données contenues dans `displayDetails` peuvent servir à piloter certains aspects du jeu, comme la résolution de rendu du jeu, et à déterminer où placer les informations essentielles ou l'interface utilisateur pour s'assurer qu'elles restent interactives et ne sont pas masquées. Les valeurs `preferredWidth` et `preferredHeight` de la structure `displayDetails` sont basées sur l'affichage réel du client de diffusion en continu, sur les limitations du système de diffusion en continu et sur les paramètres fournis par le jeu (`maxSupportedPixels`, `widestSupportedAspectRatio`, `tallestSupportedAspectRatio`). Gardez à l'esprit que les données peuvent ne pas être disponibles au démarrage du jeu et qu'elles ne sont pas nécessairement disponibles au moment de l'événement de connexion du client; les jeux doivent donc utiliser des événements ou l'interrogation. ## Exemple ```C++ theme={null} #define DEFAULT_GAME_WIDTH 1920 #define DEFAULT_GAME_HEIGHT 1080 #define GAME_WIDEST_SUPPORTED_ASPECT_RATIO 21.5f / 9.0f #define GAME_TALLEST_SUPPORTED_ASPECT_RATIO 16.0f / 10.0f static uint32_t s_currentStreamWidth = DEFAULT_GAME_WIDTH; static uint32_t s_currentStreamHeight = DEFAULT_GAME_HEIGHT; // Option 1: Event driven. Note: be aware of potential threading issues when using the task queue. void GameStreamingClientManager::OnConnectionStateChanged(XGameStreamingClientId client, XGameStreamingConnectionState connected) { // Other connection work like registering or unregistering for the client properties change events. ... UpdateResolutionIfNeeded(); } void GameStreamingClientManager::OnClientPropertiesChanged( XGameStreamingClientId client, uint32_t updatedPropertiesCount, XGameStreamingClientProperty* updatedProperties) { for (uint32_t i = 0; i < updatedPropertiesCount; ++i) { switch (updatedProperties[i]) { case XGameStreamingClientProperty::DisplayDetails: { UpdateResolutionIfNeeded(); break; } default: // A characteristic we are not tracking - do nothing break; } } } // Option 2: Polling. void Game::Update(DX::StepTimer const& timer) { ... gameStreamingClientManager->UpdateResolutionIfNeeded(); ... } void GameStreamingClientManager::UpdateResolutionIfNeeded() { bool changeResolution = false; bool useDefaultResolution = true; // Only use custom resolution when there is only one streaming client connected. if (XGameStreamingGetClientCount() == 1) { XGameStreamingClientId client; uint32_t clientsUsed = 0; HRESULT hr = XGameStreamingGetClients(1, &client, &clientsUsed); if (SUCCEEDED(hr) && clientsUsed == 1) { XGameStreamingDisplayDetails displayDetails = {}; hr = XGameStreamingGetDisplayDetails(client, DEFAULT_GAME_WIDTH * DEFAULT_GAME_HEIGHT, GAME_WIDEST_SUPPORTED_ASPECT_RATIO, GAME_TALLEST_SUPPORTED_ASPECT_RATIO, &displayDetails); if (SUCCEEDED(hr)) { useDefaultResolution = false; // Assuming the game supports all resolutions, use the stream resolution to the preferred dimensions as provided. if (s_currentStreamWidth != displayDetails.preferredWidth || s_currentStreamHeight != displayDetails.preferredHeight) { changeResolution = true; s_currentStreamWidth = displayDetails.preferredWidth; s_currentStreamHeight = displayDetails.preferredHeight; } } else { LogFormat(L"XGameStreamingGetDisplayDetails failed %x", hr); } } else { LogFormat(L"XGameStreamingGetClients failed hr=%x clientsUsed=%d", hr, clientsUsed); } } if (useDefaultResolution) { if (s_currentStreamWidth != DEFAULT_GAME_WIDTH || s_currentStreamHeight != DEFAULT_GAME_HEIGHT) { changeResolution = true; s_currentStreamWidth = DEFAULT_GAME_WIDTH; s_currentStreamHeight = DEFAULT_GAME_HEIGHT; } } if (changeResolution) { // Update the stream to the new resolution. HRESULT hr = XGameStreamingSetResolution(s_currentStreamWidth, s_currentStreamHeight); if (SUCCEEDED(hr)) { // Update the game to render at the new resolution. } else { LogFormat(L"XGameStreamingSetResolution failed %x", hr); } } } ``` ## Configuration requise **En-tête :** xgamestreaming.h\ **Bibliothèque :** xgameruntime.lib\ **Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series ## Voir aussi [XGameStreaming](/fr-CA/reference/system/xgamestreaming/xgamestreaming_members) [XGameStreamingDisplayDetails](/fr-CA/reference/system/xgamestreaming/structs/xgamestreamingdisplaydetails) [XGameStreamingRegisterClientPropertiesChanged](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged) [XGameStreamingSetResolution](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingsetresolution) [Vue d'ensemble de la résolution personnalisée](/fr-CA/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview) ## Related topics - [XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md) - [XGameStreamingDisplayDetails](/reference/system/xgamestreaming/structs/xgamestreamingdisplaydetails.md) - [XGameStreamingVideoFlags](/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md) - [XGameStreamingSetResolution](/reference/system/xgamestreaming/functions/xgamestreamingsetresolution.md)