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

Weitere Informationen

ID3D12Resource

Unterressourcen