Método ID3D12CommandQueue::CopyTileMappings (d3d12.h)

Artigo
08/23/2023

Copia mapeamentos de um recurso reservado de origem para um recurso reservado de destino.

Sintaxe

void CopyTileMappings(
  [in] ID3D12Resource                        *pDstResource,
  [in] const D3D12_TILED_RESOURCE_COORDINATE *pDstRegionStartCoordinate,
  [in] ID3D12Resource                        *pSrcResource,
  [in] const D3D12_TILED_RESOURCE_COORDINATE *pSrcRegionStartCoordinate,
  [in] const D3D12_TILE_REGION_SIZE          *pRegionSize,
       D3D12_TILE_MAPPING_FLAGS              Flags
);

Parâmetros

[in] pDstResource

Um ponteiro para o recurso reservado de destino.

[in] pDstRegionStartCoordinate

Um ponteiro para uma estrutura D3D12_TILED_RESOURCE_COORDINATE que descreve as coordenadas iniciais do recurso reservado de destino.

[in] pSrcResource

Um ponteiro para o recurso reservado de origem.

[in] pSrcRegionStartCoordinate

Um ponteiro para uma estrutura D3D12_TILED_RESOURCE_COORDINATE que descreve as coordenadas iniciais do recurso reservado de origem.

[in] pRegionSize

Um ponteiro para uma estrutura D3D12_TILE_REGION_SIZE que descreve o tamanho da região reservada.

Flags

Um membro do D3D12_TILE_MAPPING_FLAGS.

Valor retornado

Nenhum

Comentários

Use CopyTileMappings para copiar os mapeamentos de bloco de um recurso reservado para outro, seja para duplicar um mapeamento de recursos ou para inicializar um novo mapeamento antes de modificá-lo usando UpdateTileMappings.

CopyTileMappings ajuda com tarefas como a mudança de mapeamentos dentro e entre recursos reservados, por exemplo, rolagem de blocos. As regiões de origem e destino podem se sobrepor; o resultado da cópia nessa situação é como se a origem tivesse sido salva em um local temporário e de lá gravada no destino.

O destino e as regiões de origem devem se ajustar totalmente ao recurso ou o comportamento é indefinido e a camada de depuração emitirá um erro.