METODE ID3D12CommandQueue::CopyTileMappings (d3d12.h)

Artikel
08/23/2023

Menyalin pemetaan dari sumber daya yang dipesan sumber daya ke sumber daya yang dipesan tujuan.

Sintaks

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

Parameter

[in] pDstResource

Penunjuk ke sumber daya yang dipesan tujuan.

[in] pDstRegionStartCoordinate

Penunjuk ke struktur D3D12_TILED_RESOURCE_COORDINATE yang menjelaskan koordinat awal sumber daya yang dipesan tujuan.

[in] pSrcResource

Penunjuk ke sumber daya yang dipesan sumber.

[in] pSrcRegionStartCoordinate

Penunjuk ke struktur D3D12_TILED_RESOURCE_COORDINATE yang menjelaskan koordinat awal sumber daya yang dipesan sumber daya.

[in] pRegionSize

Penunjuk ke struktur D3D12_TILE_REGION_SIZE yang menjelaskan ukuran wilayah yang dipesan.

Flags

Salah satu anggota D3D12_TILE_MAPPING_FLAGS.

Nilai kembali

Tidak ada

Keterangan

Gunakan CopyTileMappings untuk menyalin pemetaan petak peta dari satu sumber daya yang dipesan ke sumber daya lain, baik untuk menduplikasi pemetaan sumber daya, atau untuk menginisialisasi pemetaan baru sebelum memodifikasinya menggunakan UpdateTileMappings.

CopyTileMappings membantu tugas seperti menggeser pemetaan di dalam dan di seluruh sumber daya yang dipesan, misalnya, menggulir petak peta. Wilayah sumber dan tujuan dapat tumpang tindih; hasil salinan dalam situasi ini seolah-olah sumber disimpan ke lokasi sementara dan dari sana ditulis ke tujuan.

Tujuan dan wilayah sumber masing-masing harus sepenuhnya pas dalam sumber daya atau perilakunya tidak terdefinisi dan lapisan debug akan memancarkan kesalahan.