Метод ID3D12CommandQueue::CopyTileMappings (d3d12.h)

Статья
08/23/2023

Копирует сопоставления из исходного зарезервированного ресурса в зарезервированный ресурс назначения.

Синтаксис

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

Параметры

[in] pDstResource

Указатель на зарезервированный ресурс назначения.

[in] pDstRegionStartCoordinate

Указатель на структуру D3D12_TILED_RESOURCE_COORDINATE , описывающую начальные координаты зарезервированного ресурса назначения.

[in] pSrcResource

Указатель на исходный зарезервированный ресурс.

[in] pSrcRegionStartCoordinate

Указатель на структуру D3D12_TILED_RESOURCE_COORDINATE , описывающую начальные координаты исходного зарезервированного ресурса.

[in] pRegionSize

Указатель на структуру D3D12_TILE_REGION_SIZE , описывающую размер зарезервированной области.

Flags

Один член D3D12_TILE_MAPPING_FLAGS.

Возвращаемое значение

None

Remarks

Используйте CopyTileMappings для копирования сопоставлений плиток из одного зарезервированного ресурса в другой либо для дублирования сопоставления ресурсов, либо для инициализации нового сопоставления перед его изменением с помощью UpdateTileMappings.

CopyTileMappings помогает выполнять такие задачи, как смещение сопоставлений в пределах зарезервированных ресурсов и между ними, например прокрутка плиток. Исходный и целевой регионы могут перекрываться; Результат копирования в этой ситуации будет таким же, как если бы источник был сохранен во временном расположении и оттуда записан в место назначения.

Конечный и исходный регионы должны полностью соответствовать их ресурсу, иначе поведение не определено, а уровень отладки выдает ошибку.