> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameStreamingGetStreamPhysicalDimensions

> XGameStreamingGetStreamPhysicalDimensions

# XGameStreamingGetStreamPhysicalDimensions

Obtiene las dimensiones físicas de la secuencia de vídeo tal como se representa en el cliente de streaming.

## Sintaxis

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

### Parámetros

*client*   \_In\_\
Tipo: XGameStreamingClientId

El cliente cuyo tamaño físico se consulta.

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

El tamaño en milímetros del eje horizontal de la secuencia de vídeo.

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

El tamaño en milímetros del eje vertical de la secuencia de vídeo.

### Valor devuelto

Tipo: HRESULT

Devuelve **S\_OK** si se realiza correctamente; de lo contrario, devuelve un código de error.

**Posibles errores**

| Código de error | Valor de error | Motivo del error |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | El entorno de ejecución de XGameStreaming no se ha inicializado. Llame a [XGameStreamingInitialize](https://docs.xbox.com/es/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md) antes de llamar a otras API. |
| E\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED | 0x89245401 | El cliente especificado no está conectado. |
| E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | Los datos solicitados no están disponibles. Es posible que los datos estén disponibles más adelante. |

Para obtener una lista de códigos de error, consulte [Códigos de error](https://docs.xbox.com/es/reference/errorcodes.md).

## Comentarios

Puede usar este método para determinar si la transmisión se enviará a un dispositivo más pequeño (por ejemplo, un smartphone).

Esto le permite presentar una experiencia más fácil para el jugador y adecuada al dispositivo (por ejemplo, usando un tamaño de fuente más grande) en función del tamaño del dispositivo.

Si quiere que el juego responda a los cambios en las dimensiones físicas de la transmisión, debe registrar una devolución de llamada mediante [XGameStreamingRegisterClientPropertiesChanged](https://docs.xbox.com/es/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged.md).

## Ejemplo

El siguiente ejemplo de código muestra cómo usar la función `XGameStreamingGetStreamPhysicalDimensions` para encontrar las dimensiones más pequeñas de un cliente de streaming.

```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;
    }
```

## Requisitos

**Encabezado:** xgamestreaming.h

**Biblioteca:** xgameruntimelib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[XGameStreaming](https://docs.xbox.com/es/reference/system/xgamestreaming/xgamestreaming_members.md)\
[XGameStreamingRegisterClientPropertiesChanged](https://docs.xbox.com/es/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged.md)\
[XGameStreaming](https://docs.xbox.com/es/reference/system/xgamestreaming/xgamestreaming_members.md#ClientProperties)


## Related topics

- [XGameStreamingClientProperty](https://docs.xbox.com/es/reference/system/xgamestreaming/enums/xgamestreamingclientproperty.md)
- [Procedimientos recomendados de desarrollo para Xbox Game Streaming](https://docs.xbox.com/es/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)
- [Directriz de accesibilidad de Xbox 101](https://docs.xbox.com/es/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md)
- [XGameStreaming (contenido de la API)](https://docs.xbox.com/es/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingGetStreamAddedLatency](https://docs.xbox.com/es/reference/system/xgamestreaming/functions/xgamestreaminggetstreamaddedlatency.md)