Metodo ID3D12CommandQueue::CopyTileMappings (d3d12.h)

Articolo
08/23/2023

Copia i mapping da una risorsa riservata di origine a una risorsa riservata di destinazione.

Sintassi

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

Parametri

[in] pDstResource

Puntatore alla risorsa riservata di destinazione.

[in] pDstRegionStartCoordinate

Puntatore a una struttura D3D12_TILED_RESOURCE_COORDINATE che descrive le coordinate iniziali della risorsa riservata di destinazione.

[in] pSrcResource

Puntatore alla risorsa riservata di origine.

[in] pSrcRegionStartCoordinate

Puntatore a una struttura D3D12_TILED_RESOURCE_COORDINATE che descrive le coordinate iniziali della risorsa riservata di origine.

[in] pRegionSize

Puntatore a una struttura D3D12_TILE_REGION_SIZE che descrive le dimensioni dell'area riservata.

Flags

Un membro di D3D12_TILE_MAPPING_FLAGS.

Valore restituito

nessuno

Osservazioni

Usare CopyTileMappings per copiare i mapping dei riquadri da una risorsa riservata a un'altra, per duplicare un mapping di risorse o per inizializzare un nuovo mapping prima di modificarlo usando UpdateTileMappings.

CopyTileMappings consente di eseguire attività quali lo spostamento dei mapping all'interno e tra le risorse riservate, ad esempio i riquadri a scorrimento. Le aree di origine e di destinazione possono sovrapporsi; il risultato della copia in questa situazione è come se l'origine fosse salvata in una posizione temporanea e da lì scritta nella destinazione.

La destinazione e le aree di origine devono adattarsi interamente alla risorsa o al comportamento non sono definite e il livello di debug genererà un errore.