ID3D12Device8::GetCopyableFootprints1-Methode (d3d12.h)

Artikel
08/23/2023

Ruft ein Ressourcenlayout ab, das kopiert werden kann. Unterstützt Ihre App beim Ausfüllen von D3D12_PLACED_SUBRESOURCE_FOOTPRINT und D3D12_SUBRESOURCE_FOOTPRINT , wenn Speicherplatz in Uploadheaps untergeordnet wird.

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

Parameter

pResourceDesc

Typ: const D3D12_RESOURCE_DESC1*

Eine Beschreibung der Ressource als Zeiger auf eine D3D12_RESOURCE_DESC1-Struktur .

FirstSubresource

Typ: [in] UINT

Index der ersten Unterressource in der Ressource. Der Bereich der gültigen Werte beträgt 0 bis D3D12_REQ_SUBRESOURCES.

NumSubresources

Typ: [in] UINT

Die Anzahl der Unterressourcen in der Ressource. Der Bereich der gültigen Werte beträgt 0 bis (D3D12_REQ_SUBRESOURCES – FirstSubresource).

BaseOffset

Typ: UINT64

Der Offset in Bytes für die Ressource.

pLayouts

Typ: [out, optional] D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Ein Zeiger auf ein Array (der Länge NumSubresources) von D3D12_PLACED_SUBRESOURCE_FOOTPRINT-Strukturen , das mit der Beschreibung und Platzierung der einzelnen Unterressourcen gefüllt werden soll.

pNumRows

Typ: [out, optional] UINT*

Ein Zeiger auf ein Array (der Länge NumSubresources) von ganzzahligen Variablen, das mit der Anzahl der Zeilen für jede Unterressource gefüllt werden soll.

pRowSizeInBytes

Typ: [out, optional] UINT64*

Ein Zeiger auf ein Array (der Länge NumSubresources) von Ganzzahlvariablen, für jeden Eintrag, der mit der nicht gepadeten Größe in Byte einer Zeile gefüllt werden soll, jeder Unterressource.

Wenn beispielsweise eine Textur2D-Ressource eine Breite von 32 und Bytes pro Pixel von 4 hat, gibt pRowSizeInBytes 128 zurück.

pRowSizeInBytes sollte nicht mit Zeilenabstand verwechselt werden, da die Untersuchung von pLayouts und das Abrufen des Zeilenabstands von ihnen 256 ergeben, da sie an D3D12_TEXTURE_DATA_PITCH_ALIGNMENT ausgerichtet ist.

pTotalBytes

Typ: [out, optional] UINT64*

Ein Zeiger auf eine ganzzahlige Variable, die mit der Gesamtgröße in Bytes gefüllt werden soll.

Rückgabewert

Keine

Bemerkungen

Hinweise und Beispiele finden Sie unter ID3D12Device::GetCopyableFootprints.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Kopfzeile	d3d12.h
Bibliothek	d3d12.lib
DLL	d3d12.dll

Share via