Método ID3D12GraphicsCommandList1::ResolveSubresourceRegion (d3d12.h)

Copie uma região de um recurso multisampled ou compactado em um recurso não multissampled ou não compactado.

Sintaxe

void ResolveSubresourceRegion(
  [in]           ID3D12Resource     *pDstResource,
  [in]           UINT               DstSubresource,
  [in]           UINT               DstX,
  [in]           UINT               DstY,
  [in]           ID3D12Resource     *pSrcResource,
  [in]           UINT               SrcSubresource,
  [in, optional] D3D12_RECT         *pSrcRect,
  [in]           DXGI_FORMAT        Format,
  [in]           D3D12_RESOLVE_MODE ResolveMode
);

Parâmetros

[in] pDstResource

Tipo: ID3D12Resource*

SAL: In

Recurso de destino. Deve ser criado com o sinalizador D3D11_USAGE_DEFAULT e deve ser amostrado individualmente, a menos que seja resolvido de um recurso compactado (D3D12_RESOLVE_MODE_DECOMPRESS); nesse caso, ele deve ter a mesma contagem de exemplo que a origem compactada.

[in] DstSubresource

Tipo: UINT

SAL: In

Um índice baseado em zero que identifica o sub-recurso de destino. Use D3D12CalcSubresource para calcular o índice de sub-fonte se o recurso pai for complexo.

[in] DstX

Tipo: UINT

SAL: In

A coordenada X da borda mais à esquerda da região de destino. A largura da região de destino é a mesma da largura do rect de origem.

[in] DstY

Tipo: UINT

SAL: In

A coordenada Y da borda superior da região de destino. A altura da região de destino é a mesma que a altura do rect de origem.

[in] pSrcResource

Tipo: ID3D12Resource*

SAL: In

Recurso de origem. Deve ser multisampled ou compactado.

[in] SrcSubresource

Tipo: UINT

SAL: In

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

[in, optional] pSrcRect

Tipo: D3D12_RECT*

SAL: In_opt

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

[in] Format

Tipo: DXGI_FORMAT

SAL: In

Um DXGI_FORMAT que especifica como os formatos de recurso de origem e de destino são consolidados.

[in] ResolveMode

Tipo: D3D12_RESOLVE_MODE

SAL: In

Especifica a operação usada para resolve os exemplos de origem.

Ao usar a operação D3D12_RESOLVE_MODE_DECOMPRESS , a contagem de exemplos pode ser maior que 1, desde que a origem e o destino tenham a mesma contagem de exemplo, e a origem e o destino podem especificar o mesmo recurso, desde que a rect de origem se alinhe 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 exemplo de 1.

Retornar valor

Nenhum

Comentários

ResolveSubresourceRegion opera como ResolveSubresource, mas permite que apenas parte de um recurso seja resolvida e que exemplos de origem sejam resolvidos de várias maneiras. As resoluções parciais podem ser úteis em cenários de vários adaptadores; por exemplo, quando a área renderizada tiver sido particionada entre adaptadores, cada adaptador só precisará resolve a parte de um sub-recurso que corresponde à partição atribuída.

Requisitos

Confira também

ID3D12GraphicsCommandList1