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

> Copia uma região de um recurso multiamostrado ou compactado para um recurso não multiamostrado ou não compactado.

Copia uma região de um recurso multiamostrado ou compactado para um recurso não multiamostrado ou não compactado.

## Sintaxe

```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
)
```

### Parâmetros

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

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

Recurso de destino. Deve ser criado com o sinalizador **D3D11\_USAGE\_DEFAULT** e deve ser de amostra única, a menos que seja resolvido a partir de um recurso compactado (**D3D12\_RESOLVE\_MODE\_DECOMPRESS**); nesse caso, ele deve ter a mesma contagem de amostras que a origem compactada.

*DstSubresource \[in]*\
Tipo: UINT

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

Um índice baseado em zero que identifica o sub-recurso de destino. Use [D3D12CalcSubresource](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12calcsubresource) para calcular o índice do sub-recurso se o recurso pai for complexo.

*DstX \[in]*\
Tipo: UINT

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

A coordenada X da borda mais à esquerda da região de destino. A largura da região de destino é igual à largura do retângulo de origem.

*DstY \[in]*\
Tipo: UINT

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

A coordenada Y da borda superior da região de destino. A altura da região de destino é igual à altura do retângulo de origem.

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

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

Recurso de origem. Deve ser multiamostrado ou compactado.

*SrcSubresource \[in]*\
Tipo: UINT

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

Um índice baseado em zero que identifica o sub-recurso de origem.

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

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

Especifica a região retangular do recurso de origem a ser resolvida. Passar NULL para <i>pSrcRect</i> especifica que todo o sub-recurso deve ser resolvido.

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

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

Um DXGI\_FORMAT que especifica como os formatos dos recursos de origem e de destino são consolidados.

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

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

Especifica a operação usada para resolver as amostras de origem.

Ao usar a operação **D3D12\_RESOLVE\_MODE\_DECOMPRESS**, a contagem de amostras pode ser maior que 1, desde que a origem e o destino tenham a mesma contagem de amostras, e a origem e o destino podem especificar o mesmo recurso, desde que o retângulo de origem esteja alinhado com as coordenadas X e Y de destino; nesse caso, a descompactação ocorre no local.

Ao usar a operação **D3D12\_RESOLVE\_MODE\_MIN**, **D3D12\_RESOLVE\_MODE\_MAX** ou **D3D12\_RESOLVE\_MODE\_AVERAGE**, o destino deve ter uma contagem de amostras igual a 1.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

ResolveSubresourceRegion funciona como [ResolveSubresource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_resolvesubresource_public), mas permite que apenas parte de um recurso seja resolvida e que as amostras de origem sejam resolvidas de várias maneiras. Resoluções parciais podem ser úteis em cenários com vários adaptadores; por exemplo, quando a área renderizada foi particionada entre adaptadores, cada adaptador pode precisar resolver apenas a parte de um sub-recurso que corresponde à partição atribuída a ele.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12GraphicsCommandList1](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/id3d12graphicscommandlist1_public)


## Related topics

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