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

# GetDisplayModeListX (consoles XBOX Series)

> GetDisplayModeListX (consoles XBOX Series) — Obtém os modos de exibição que correspondem ao formato solicitado e a outras opções de entrada.

Obtém os modos de exibição que correspondem ao formato solicitado e a outras opções de entrada.

Esta API é semelhante a [GetDisplayModeList](/pt-BR/reference/graphics/d3d12_xs/interfaces/IDXGIOutput/methods/idxgioutput_getdisplaymodelist), mas fornece mais informações específicas do XBOX Series X|S, como o suporte à Taxa de Atualização Variável.

Consulte [DXGIXBOX\_MODE\_DESC](/pt-BR/reference/graphics/d3d12_xs/structs/dxgixbox_mode_desc) para obter mais informações.

Esta

## Sintaxe

```cpp theme={null}
HRESULT GetDisplayModeListX(  
         DXGI_FORMAT EnumFormat,  
         UINT Flags,  
         UINT* pNumModes,  
         DXGIXBOX_MODE_DESC *pDesc  
)  
```

### Parâmetros

*EnumFormat*   \_In\_\
Tipo: [DXGI\_FORMAT](/pt-BR/reference/graphics/d3d12_xs/enums/dxgi_format)

O formato de cor do buffer de fundo (consulte [DXGI\_FORMAT](/pt-BR/reference/graphics/d3d12_xs/enums/dxgi_format)).  Este parâmetro não é usado no XBOX Series X|S.  Use o formato do seu buffer de fundo.

*Flags*   \_In\_\
Tipo: UINT

Este parâmetro não é usado no XBOX Series X|S.  Use o valor 0.

*pNumModes*   \_Inout\_\
Tipo: UINT\*

Defina pDesc como NULL para que pNumModes retorne o número de modos de exibição que correspondem ao formato e às opções. Caso contrário, pNumModes retorna o número de modos de exibição retornados em pDesc.

\**pDesc*   \_Out\_writes\_to\_opt\_(\*pNumModes,\*pNumModes)\
Tipo: [DXGIXBOX\_MODE\_DESC](/pt-BR/reference/graphics/d3d12_xs/structs/dxgixbox_mode_desc)

Um ponteiro para uma lista de modos de exibição (consulte [DXGIXBOX\_MODE\_DESC](/pt-BR/reference/graphics/d3d12_xs/structs/dxgixbox_mode_desc)); defina como NULL para obter o número de modos de exibição.

### Valor retornado

Tipo: HRESULT

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

## Comentários

No XBOX Series X|S, esta API foi projetada para ser usada por títulos que desejam verificar se a tela oferece suporte a 120 Hz.  Os títulos devem chamar esta API e verificar o suporte a 120 Hz ou 40 Hz antes de chamar [ID3D12Device::SetFrameIntervalX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_setframeintervalx) com D3D12XBOX\_FRAME\_INTERVAL\_120\_HZ ou D3D12XBOX\_FRAME\_INTERVAL\_40\_HZ.

Conforme mostrado, esta API foi projetada para ser chamada duas vezes. Primeiro, para obter o número de modos disponíveis e, em segundo lugar, para retornar uma descrição dos modos.

```cpp theme={null}
UINT num = 0;
DXGI_FORMAT format = DXGI_FORMAT_R8G8B8A8_UNORM;

pOutput->GetDisplayModeListX( format, 0, &num, 0 );

...

DXGIXBOX_MODE_DESC * pDescs = new DXGIXBOX_MODE_DESC[num];
pOutput->GetDisplayModeListX( format, 0, &num, pDescs );
```

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

- [XDisplayHdrModeInfo](/pt-BR/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XDisplayHdrModePreference](/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [XDisplayHdrModeResult](/pt-BR/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md)
- [XDisplayTryEnableHdrMode](/pt-BR/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)
- [XGameStreamingGetDisplayDetails](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md)