> ## 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.

# XGameStreamingGetStreamPhysicalDimensions

> XGameStreamingGetStreamPhysicalDimensions

# XGameStreamingGetStreamPhysicalDimensions

Obtient les dimensions physiques du flux vidéo tel qu'il est rendu sur le client de diffusion en continu.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XGameStreamingGetStreamPhysicalDimensions(
         XGameStreamingClientId client,
         uint32_t* horizontalMm,
         uint32_t* verticalMm
)
```

<a id="parametersSection" />

### Paramètres

*client*   \_In\_\
Type : XGameStreamingClientId

Client dont la taille physique est interrogée.

*horizontalMm*   \_Out\_\
Type : uint32\_t\*

Taille en millimètres de l'axe horizontal du flux vidéo.

*verticalMm*   \_Out\_\
Type : uint32\_t\*

Taille en millimètres de l'axe vertical du flux vidéo.

<a id="retvalSection" />

### 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](/fr-CA/reference/system/xgamestreaming/functions/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. |

Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes).

<a id="remarksSection" />

## Remarques

Vous pouvez utiliser cette méthode pour déterminer si le flux sera envoyé à un appareil plus petit (par exemple, un téléphone intelligent).

Cela vous permet de présenter une expérience plus conviviale pour le joueur et adaptée à l'appareil (par exemple, en utilisant une taille de police plus grande) en fonction de la taille de l'appareil.

Si vous souhaitez que le jeu réagisse aux changements des dimensions physiques du flux, vous devez inscrire un rappel au moyen de [XGameStreamingRegisterClientPropertiesChanged](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged).

<a id="exampleSection" />

## Exemple

L'exemple de code suivant montre comment utiliser la fonction `XGameStreamingGetStreamPhysicalDimensions` pour trouver les plus petites dimensions d'un client de diffusion en continu.

```cpp theme={null}
void GetSmallestStreamingClient(uint32_t& widthMm, uint32_t& heightMm)
    {
        // If we don't know what the smallest client is, then search through them to find it
        if (m_smallestClient == XGameStreamingNullClientId)
        {
            for (const auto client : m_streamingClients)
            {
                if (client.clientId != XGameStreamingNullClientId)
                {
                    uint32_t clientWidthMm = 0;
                    uint32_t clientHeightMm = 0;
                    if (SUCCEEDED(XGameStreamingGetStreamPhysicalDimensions(client.clientId, &clientWidthMm, &clientHeightMm)))
                    {
                        if (clientWidthMm < m_smallestClientWidthMm)
                        {
                            m_smallestClientWidthMm = clientWidthMm;
                            m_smallestClientHeightMm = clientHeightMm;
                        }
                    }
                }
            }
        }

        widthMm = m_smallestClientWidthMm;
        heightMm = m_smallestClientHeightMm;
    }
```

<a id="requirementsSection" />

## Configuration requise

**En-tête :** xgamestreaming.h

**Bibliothèque :** xgameruntimelib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Voir aussi

[XGameStreaming](/fr-CA/reference/system/xgamestreaming/xgamestreaming_members)\
[XGameStreamingRegisterClientPropertiesChanged](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged)\
[XGameStreaming](/fr-CA/reference/system/xgamestreaming/xgamestreaming_members#ClientProperties)


## Related topics

- [XGameStreamingGetStreamPhysicalDimensions](/reference/system/xgamestreaming/functions/xgamestreaminggetstreamphysicaldimensions.md)
- [XGameStreamingClientProperty](/reference/system/xgamestreaming/enums/xgamestreamingclientproperty.md)
- [Optimizing your game for XBOX Game Streaming](/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)
- [XBOX Game Streaming을 위한 게임 최적화](/ko/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)
- [Optimización de tu juego para XBOX Game Streaming](/es/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)