ID3D12Device8::GetCopyableFootprints1-Methode (d3d12.h)
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 |