Share via


Método ID3D12GraphicsCommandList::ResolveSubresource (d3d12.h)

Copie um recurso de várias amostras em um recurso não multi-amostrado.

Sintaxe

void ResolveSubresource(
  ID3D12Resource *pDstResource,
  UINT           DstSubresource,
  ID3D12Resource *pSrcResource,
  UINT           SrcSubresource,
  DXGI_FORMAT    Format
);

Parâmetros

pDstResource

Tipo: [in] ID3D12Resource*

Recurso de destino. Deve ser um criado em um heap de D3D12_HEAP_TYPE_DEFAULT e ter uma amostra única. Consulte ID3D12Resource.

DstSubresource

Tipo: [in] UINT

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

pSrcResource

Tipo: [in] ID3D12Resource*

Recurso de origem. Deve ser multisampled.

SrcSubresource

Tipo: [in] UINT

O sub-recurso de origem do recurso de origem.

Format

Tipo: [in] DXGI_FORMAT

Um DXGI_FORMAT que indica como o recurso com várias amostras será resolvido para um recurso de amostra única. Consulte Observações.

Valor retornado

Nenhum

Comentários

Camada de depuração

A camada de depuração emitirá um erro se os sub-recursos referenciados pela exibição de origem não estiverem no estado D3D12_RESOURCE_STATE_RESOLVE_SOURCE .

A camada de depuração emitirá um erro se o buffer de destino não estiver no estado D3D12_RESOURCE_STATE_RESOLVE_DEST .

Os recursos de origem e destino devem ser do mesmo tipo de recurso e ter as mesmas dimensões. Além disso, eles devem ter formatos compatíveis. Há três cenários para isso:

Cenário Requisitos
A origem e o destino são pré-estruturados e digitados A origem e o destino devem ter formatos idênticos e esse formato deve ser especificado no parâmetro Format.
Um recurso é pré-estruturado e digitado e o outro é pré-estruturado e sem tipo O recurso tipado deve ter um formato compatível com o recurso sem tipo (ou seja, o recurso tipado é DXGI_FORMAT_R32_FLOAT e o recurso sem tipo é DXGI_FORMAT_R32_TYPELESS). O formato do recurso tipado deve ser especificado no parâmetro Format.
A origem e o destino são pré-estruturados e sem tipo A origem e o destino devem ter o mesmo formato sem tipo (ou seja, ambos devem ter DXGI_FORMAT_R32_TYPELESS) e o parâmetro Format deve especificar um formato compatível com a origem e o destino (ou seja, se ambos forem DXGI_FORMAT_R32_TYPELESS então DXGI_FORMAT_R32_FLOAT poderão ser especificados no parâmetro Format). Por exemplo, considerando o formato DXGI_FORMAT_R16G16B16A16_TYPELESS:
  • O formato de origem (ou dest) pode ser DXGI_FORMAT_R16G16B16A16_UNORM
  • O formato dest (ou source) pode ser DXGI_FORMAT_R16G16B16A16_FLOAT

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d12.h
Biblioteca D3d12.lib
DLL D3d12.dll

Confira também

ID3D12GraphicsCommandList

Sub-recursos