Condividi tramite

Metodo ID3D12Device8::GetCopyableFootprints1 (d3d12.h)

  • Articolo

Ottiene un layout di risorsa che può essere copiato. Aiuta l'app a compilare D3D12_PLACED_SUBRESOURCE_FOOTPRINT e D3D12_SUBRESOURCE_FOOTPRINT quando si esegue il suballocating dello spazio in heaps di caricamento.

Sintassi

void GetCopyableFootprints1(
  const D3D12_RESOURCE_DESC1         *pResourceDesc,
  UINT                               FirstSubresource,
  UINT                               NumSubresources,
  UINT64                             BaseOffset,
  D3D12_PLACED_SUBRESOURCE_FOOTPRINT *pLayouts,
  UINT                               *pNumRows,
  UINT64                             *pRowSizeInBytes,
  UINT64                             *pTotalBytes
);

Parametri

pResourceDesc

Tipo: const D3D12_RESOURCE_DESC1*

Descrizione della risorsa, come puntatore a una struttura D3D12_RESOURCE_DESC1 .

FirstSubresource

Tipo: [in] UINT

Indice della prima sottoresource nella risorsa. L'intervallo di valori validi è da 0 a D3D12_REQ_SUBRESOURCES.

NumSubresources

Tipo: [in] UINT

Numero di sottoresource nella risorsa. L'intervallo di valori validi è da 0 a (D3D12_REQ_SUBRESOURCES - FirstSubresource).

BaseOffset

Tipo: UINT64

Offset, in byte, alla risorsa.

pLayouts

Tipo: [out, facoltativo] D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Puntatore a una matrice (di lunghezza NumSubresources) di strutture D3D12_PLACED_SUBRESOURCE_FOOTPRINT , da riempire con la descrizione e la posizione di ogni sottoresource.

pNumRows

Tipo: [out, facoltativo] UINT*

Puntatore a una matrice (di lunghezza NumSubresources) di variabili integer, da riempire con il numero di righe per ogni sottoresource.

pRowSizeInBytes

Tipo: [out, facoltativo] UINT64*

Puntatore a una matrice (di lunghezza NumSubresources) di variabili integer, ogni voce deve essere riempita con le dimensioni senza blocco in byte di una riga, di ogni sottorisorsa.

Ad esempio, se una risorsa Texture2D ha una larghezza di 32 e byte per pixel pari a 4, pRowSizeInBytes restituisce 128.

pRowSizeInBytes non deve essere confusa con il passo delle righe, come l'esame di pLayouts e l'acquisizione del passo della riga da questo vi darà 256 come è allineato a D3D12_TEXTURE_DATA_PITCH_ALIGNMENT.

pTotalBytes

Tipo: [out, facoltativo] UINT64*

Puntatore a una variabile integer, da riempire con le dimensioni totali, in byte.

Valore restituito

nessuno

Osservazioni

Per osservazioni ed esempi, vedere ID3D12Device::GetCopyableFootprints.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Intestazione d3d12.h
Libreria d3d12.lib
DLL d3d12.dll

Vedi anche