> ## 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. 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 la 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. 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. Passer 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 comment 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 sources.

Avec l'opération **D3D12\_RESOLVE\_MODE\_DECOMPRESS**, le nombre d'échantillons peut être supérieur à 1 à condition que la source et la destination aient le même nombre d'échantillons; la source et la destination peuvent aussi désigner la même ressource à condition que le rectangle source soit aligné sur les coordonnées X et Y de destination, auquel cas la décompression s'effectue sur place.

Avec les opérations **D3D12\_RESOLVE\_MODE\_MIN**, **D3D12\_RESOLVE\_MODE\_MAX** ou **D3D12\_RESOLVE\_MODE\_AVERAGE**, la destination doit avoir un nombre d'échantillons égal à 1.

### Valeur de retour

Type : void

Aucune.

## Remarques

ResolveSubresourceRegion fonctionne comme [ResolveSubresource](/fr-CA/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 sources de plusieurs façons. Les résolutions partielles peuvent être utiles dans les scénarios multiadaptateurs; par exemple, lorsque la zone rendue a été partitionnée entre des adaptateurs, chaque adaptateur pourrait n'avoir besoin de résoudre que la portion d'une sous-ressource qui correspond à la partition qui lui est 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-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/id3d12graphicscommandlist1_public)


## Related topics

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