ID3D12Resource::ReadFromSubresource-Methode (d3d12.h)
Verwendet die CPU zum Kopieren von Daten aus einer Unterressource, sodass die CPU den Inhalt der meisten Texturen mit nicht definierten Layouts lesen kann.
Syntax
HRESULT ReadFromSubresource(
[out] void *pDstData,
UINT DstRowPitch,
UINT DstDepthPitch,
UINT SrcSubresource,
[in, optional] const D3D12_BOX *pSrcBox
);
Parameter
[out] pDstData
Typ: void*
Ein Zeiger auf die Zieldaten im Arbeitsspeicher.
DstRowPitch
Typ: UINT
Der Abstand zwischen einer Zeile mit Zieldaten und der nächsten Zeile.
DstDepthPitch
Typ: UINT
Der Abstand von einem Tiefenschnitt von Zieldaten zum nächsten.
SrcSubresource
Typ: UINT
Gibt den Index der Unterquelle an, aus der gelesen werden soll.
[in, optional] pSrcBox
Typ: const D3D12_BOX*
Ein Zeiger auf ein Feld, das den Teil der Zielunterquelle definiert, aus dem die Ressourcendaten kopiert werden sollen. Bei NULL werden die Daten aus der Zielunterquelle ohne Offset gelesen. Die Dimensionen des Ziels müssen dem Ziel entsprechen (siehe D3D12_BOX).
Ein leeres Feld führt zu einer Nicht-Op. Ein Feld ist leer, wenn der oberste Wert größer oder gleich dem unteren Wert ist, oder wenn der linke Wert größer oder gleich dem rechten Wert ist, oder wenn der Frontwert größer als oder gleich dem back-Wert ist. Wenn das Feld leer ist, führt diese Methode keinen Vorgang aus.
Rückgabewert
Typ: HRESULT
Diese Methode gibt einen der Direct3D 12-Rückgabecodes zurück.
Hinweise
Weitere Informationen finden Sie im Abschnitt Hinweise zu WriteToSubresource.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d12.h |
| Bibliothek | D3d12.lib |
| DLL | D3d12.dll |