Condividi tramite

Metodo ID3D12Device8::GetCopyableFootprints1 (d3d12.h)

Ottiene un layout di risorsa che può essere copiato. Consente all'app di compilare D3D12_PLACED_SUBRESOURCE_FOOTPRINT e D3D12_SUBRESOURCE_FOOTPRINT quando si esegue il suballocating dello spazio negli heap di caricamento.

Syntax

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

Parameters

pResourceDesc

Tipo: const D3D12_RESOURCE_DESC1*

Descrizione della risorsa, come puntatore a una struttura D3D12_RESOURCE_DESC1 .

FirstSubresource

Tipo: [in] UINT

Indice della prima sottorisorsa nella risorsa. L'intervallo di valori validi è compreso tra 0 e D3D12_REQ_SUBRESOURCES.

NumSubresources

Tipo: [in] UINT

Numero di sottorisorse nella risorsa. L'intervallo di valori validi è compreso tra 0 e (D3D12_REQ_SUBRESOURCES - FirstSubresource).

BaseOffset

Tipo: UINT64

Offset, in byte, aggiunto all'offset di ogni D3D12_PLACED_SUBRESOURCE_FOOTPRINT nella matrice pLayouts .

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 sottorisorsa.

pNumRows

Tipo: [out, facoltativo] UINT*

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

pRowSizeInBytes

Tipo: [out, facoltativo] UINT64*

Puntatore a una matrice (di lunghezza NumSubresources) di variabili integer, ogni voce da riempire con le dimensioni senzapad in byte di una riga, di ogni sottorisorsa.

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

pRowSizeInBytes non deve essere confuso con il passo di riga, come l'esame di pLayout e il recupero del passo di 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. Se pResourceDesc non è valido, il valore di pTotalBytes viene impostato su UINT64_MAX.

Valore restituito

None

Remarks

Per osservazioni ed esempi, vedere ID3D12Device::GetCopyableFootprints.

Requirements

Requirement Value
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Header d3d12.h
Library d3d12.lib
DLL d3d12.dll

Vedere anche

  • Last updated on