Pular para o conteúdo principal
Copia uma região de um recurso multiamostrado ou compactado para um recurso não multiamostrado ou não compactado.

Sintaxe

Parâmetros

pDstResource [in]
Tipo: ID3D12Resource *
SAL: In 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: In Um índice baseado em zero que identifica o sub-recurso de destino. Use D3D12CalcSubresource para calcular o índice do sub-recurso se o recurso pai for complexo. DstX [in]
Tipo: UINT
SAL: In 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: In 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: In Recurso de origem. Deve ser multiamostrado ou compactado. SrcSubresource [in]
Tipo: UINT
SAL: In Um índice baseado em zero que identifica o sub-recurso de origem. pSrcRect [in, optional]
Tipo: D3D12_RECT *
SAL: In_opt Especifica a região retangular do recurso de origem a ser resolvida. Passar NULL para pSrcRect especifica que todo o sub-recurso deve ser resolvido. Format [in]
Tipo: DXGI_FORMAT
SAL: In 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: In 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, 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
Última modificação em 6 de outubro de 2026