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

# ResolveSubresourceRegion

> Copie une région d'une ressource multiéchantillonnée ou compressée dans une ressource non multiéchantillonnée ou non compressée.

Copie une région d'une ressource multiéchantillonnée ou compressée dans une ressource non multiéchantillonnée ou non compressée.

## Syntaxe

```cpp theme={null}
void ResolveSubresourceRegion(
    ID3D12Resource  pDstResource,
    UINT DstSubresource,
    UINT DstX,
    UINT DstY,
    ID3D12Resource  pSrcResource,
    UINT SrcSubresource,
    D3D12_RECT  pSrcRect,
    DXGI_FORMAT Format,
    D3D12_RESOLVE_MODE ResolveMode
)
```

### Paramètres

*pDstResource \[in]*\
Type : ID3D12Resource \*

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In*</code>

Ressource de destination. Elle doit être créée avec l'indicateur **D3D11\_USAGE\_DEFAULT** et doit être à échantillon unique, sauf si elle doit être résolue à partir d'une ressource compressée (**D3D12\_RESOLVE\_MODE\_DECOMPRESS**) ; dans ce cas, elle doit avoir le même nombre d'échantillons que la source compressée.

*DstSubresource \[in]*\
Type : UINT

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In*</code>

Index de base zéro qui identifie la sous-ressource de destination. Utilisez [D3D12CalcSubresource](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12calcsubresource) pour calculer l'index de sous-ressource si la ressource parente est complexe.

*DstX \[in]*\
Type : UINT

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In*</code>

Coordonnée X du bord le plus à gauche de la région de destination. La largeur de la région de destination est identique à celle du rectangle source.

*DstY \[in]*\
Type : UINT

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In*</code>

Coordonnée Y du bord le plus haut de la région de destination. La hauteur de la région de destination est identique à celle du rectangle source.

*pSrcResource \[in]*\
Type : ID3D12Resource \*

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In*</code>

Ressource source. Elle doit être multiéchantillonnée ou compressée.

*SrcSubresource \[in]*\
Type : UINT

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In*</code>

Index de base zéro qui identifie la sous-ressource source.

*pSrcRect \[in, optional]*\
Type : D3D12\_RECT \*

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In\_opt*</code>

Spécifie la région rectangulaire de la ressource source à résoudre. Le passage de NULL pour <i>pSrcRect</i> indique que la sous-ressource entière doit être résolue.

*Format \[in]*\
Type : DXGI\_FORMAT

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In*</code>

Valeur DXGI\_FORMAT qui spécifie la façon dont les formats des ressources source et de destination sont consolidés.

*ResolveMode \[in]*\
Type : D3D12\_RESOLVE\_MODE

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values) : <code>*In*</code>

Spécifie l'opération utilisée pour résoudre les échantillons source.

Lors de l'utilisation de l'opération **D3D12\_RESOLVE\_MODE\_DECOMPRESS**, le nombre d'échantillons peut être supérieur à 1 tant que la source et la destination ont le même nombre d'échantillons, et la source et la destination peuvent spécifier la même ressource tant que le rectangle source est aligné sur les coordonnées X et Y de destination, auquel cas la décompression s'effectue sur place.

Lors de l'utilisation de l'opération **D3D12\_RESOLVE\_MODE\_MIN**, **D3D12\_RESOLVE\_MODE\_MAX** ou **D3D12\_RESOLVE\_MODE\_AVERAGE**, la destination doit avoir un nombre d'échantillons égal à 1.

### Valeur renvoyée

Type : void

Aucune.

## Remarques

ResolveSubresourceRegion fonctionne comme [ResolveSubresource](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_resolvesubresource_public), mais permet de ne résoudre qu'une partie d'une ressource et de résoudre les échantillons source de plusieurs façons. Les résolutions partielles peuvent être utiles dans les scénarios multicarte ; par exemple, lorsque la zone rendue a été partitionnée entre plusieurs cartes, chaque carte peut n'avoir besoin de résoudre que la partie d'une sous-ressource qui correspond à sa partition attribuée.

## Configuration requise

**En-tête :** d3d12\_xs.h ou d3d12\_x.h\
**Bibliothèque :** d3d12\_xs.lib ou d3d12\_x.lib\
**Plateformes prises en charge** : consoles XBOX Series et famille XBOX One

## Voir aussi

[ID3D12GraphicsCommandList1](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/id3d12graphicscommandlist1_public)


## Related topics

- [D3D12_RESOLVE_MODE](/fr/reference/graphics/d3d12/enums/d3d12_resolve_mode_public.md)
- [SetSamplePositions](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_setsamplepositions_public.md)
- [D3D12_RENDER_PASS_ENDING_ACCESS_RESOLVE_SUBRESOURCE_PARAMETERS](/fr/reference/graphics/d3d12/structs/d3d12_render_pass_ending_access_resolve_subresource_parameters_public.md)
- [D3D12_RENDER_PASS_ENDING_ACCESS_RESOLVE_PARAMETERS](/fr/reference/graphics/d3d12/structs/d3d12_render_pass_ending_access_resolve_parameters_public.md)
- [D3D12_DISCARD_REGION](/fr/reference/graphics/d3d12/structs/d3d12_discard_region_public.md)