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

# GetAspectRatio (consoles XBOX Series)

> Obtém a proporção da tela.

Obtém a proporção da tela.

## Sintaxe

```cpp theme={null}
HRESULT GetAspectRatio(  
         DXGI_RATIONAL* pAspectRatio  
)  
```

### Parâmetros

*pAspectRatio*   \_Out\_\
Tipo: DXGI\_RATIONAL\*

Um ponteiro para as informações de proporção.

### Valor retornado

Tipo: HRESULT

Retorna S\_OK em caso de êxito ou E\_INVALIDARG quando chamado com parâmetros inválidos.

## Comentários

Este método sempre retornará o valor 16:9 no XBOX Series X|S.

## Requisitos

**Cabeçalho:** d3d12\_xs.h

**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[IDXGIOutput](/pt-BR/reference/graphics/d3d12_xs/interfaces/IDXGIOutput/idxgioutput)


## Related topics

- [Best Practices for Game Streaming Custom Resolution](/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices.md)
- [GetShapeEqCompRatio](/reference/audio/shapeeqcompcontext/functions/getshapeeqcompratio.md)
- [XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md)
- [Custom Resolution Overview](/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview.md)
- [Testing With Custom Resolution](/build/core-features/common/game-streaming/game-streaming-testing-custom-resolution.md)