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

# GetDisplayModeList (consoles XBOX Series)

> GetDisplayModeList (consoles XBOX Series) : obtient les modes d'affichage qui correspondent au format demandé et aux autres options d'entrée. Référence graphique XBOX Direct3D 12.

Obtient les modes d'affichage qui correspondent au format demandé et aux autres options d'entrée.

## Syntaxe

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

### Paramètres

*EnumFormat*   \_In\_\
Type : [DXGI\_FORMAT](/fr-CA/reference/graphics/d3d12_xs/enums/dxgi_format)

Le format de couleur de la mémoire tampon d'arrière-plan (voir [DXGI\_FORMAT](/fr-CA/reference/graphics/d3d12_xs/enums/dxgi_format)).  Ce paramètre n'est pas utilisé sur XBOX Series X|S.  Utilisez le format de votre mémoire tampon d'arrière-plan.

*Flags*   \_In\_\
Type : UINT

Ce paramètre n'est pas utilisé sur XBOX Series X|S.  Utilisez la valeur 0.

*pNumModes*   \_Inout\_\
Type : UINT\*

Définissez pDesc sur NULL pour que pNumModes retourne le nombre de modes d'affichage qui correspondent au format et aux options. Sinon, pNumModes retourne le nombre de modes d'affichage retournés dans pDesc.

\**pDesc*   \_Out\_writes\_to\_opt\_(\*pNumModes,\*pNumModes)\
Type : [DXGI\_MODE\_DESC](/fr-CA/reference/graphics/d3d12_xs/structs/dxgi_mode_desc)

Un pointeur vers une liste de modes d'affichage (voir [DXGI\_MODE\_DESC](/fr-CA/reference/graphics/d3d12_xs/structs/dxgi_mode_desc)); définissez-le sur NULL pour obtenir le nombre de modes d'affichage.

### Valeur de retour

Type : HRESULT

Retourne S\_OK en cas de réussite ou E\_INVALIDARG en cas d'appel avec des paramètres non valides.

## Remarques

Sur XBOX Series X|S, cette API est conçue pour les titres qui souhaitent vérifier la prise en charge de 120 Hz par l'affichage.  Les titres doivent appeler cette API et vérifier la prise en charge de 120 Hz ou de 40 Hz avant d'appeler [ID3D12Device::SetFrameIntervalX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_setframeintervalx) avec D3D12XBOX\_FRAME\_INTERVAL\_120\_HZ ou D3D12XBOX\_FRAME\_INTERVAL\_40\_HZ.

Comme illustré, cette API est conçue pour être appelée deux fois : d'abord pour obtenir le nombre de modes disponibles, puis pour retourner une description des modes.

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

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

...

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

## Configuration requise

**En-tête :** d3d12\_xs.h

**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge :** consoles XBOX Series

## Voir aussi

[IDXGIOutput](/fr-CA/reference/graphics/d3d12_xs/interfaces/IDXGIOutput/idxgioutput)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [XDisplayHdrModePreference](/reference/system/xdisplay/enums/xdisplayhdrmodepreference.md)
- [XDisplayHdrModeResult](/reference/system/xdisplay/enums/xdisplayhdrmoderesult.md)
- [XDisplayHdrModeInfo](/reference/system/xdisplay/structs/xdisplayhdrmodeinfo.md)
- [XDisplayTryEnableHdrMode](/reference/system/xdisplay/functions/xdisplaytryenablehdrmode.md)