D3D10DDI_MAPPED_SUBRESOURCE-Struktur (d3d10umddi.h)
Die D3D10DDI_MAPPED_SUBRESOURCE-Struktur beschreibt eine Unterressource, der der Treiber über einen Aufruf der ResourceMap-Funktion des Treibers zuordnet.
Syntax
typedef struct D3D10DDI_MAPPED_SUBRESOURCE {
[out] void *pData;
[out] UINT RowPitch;
[out] UINT DepthPitch;
} D3D10DDI_MAPPED_SUBRESOURCE;
Member
[out] pData
Ein Zeiger auf einen Puffer, der den Inhalt der Unterressource enthält.
[out] RowPitch
Zeilenabstand, Breite oder physische Größe (in Bytes) der Daten.
[out] DepthPitch
Der Tiefenabstand, die Breite oder die physische Größe (in Byte) der Daten.
Hinweise
Das pData-Element zeigt auf Zeile 0 und Slice 0.
Das RowPitch-Element ist der Wert, der pData hinzugefügt wird, um von Zeile zu Zeile zu wechseln. Jede Zeile sollte mehrere Pixel enthalten.
Das DepthPitch-Element ist der Wert, der pData hinzugefügt wird, um vom Tiefenslice zum Tiefenslice zu wechseln. Jeder Tiefenslice sollte mehrere Zeilen enthalten.
Es ist nicht ratsam, den RowPitch - und DepthPitch-Membern den Wert 0 zuzuweisen.
Um null Werte für diese Member zu vermeiden, hilft es, sich alle Ressourcen als dreidimensional zu vorstellen, wie in diesen beiden Beispielen gezeigt:
- Wenn das Ressourcenattribute Buffer oder Texture1D lautet und 8 Bytes enthält, sind die geeigneten Werte für RowPitch und DepthPitch 8 oder mehr.
- Wenn das Ressourcensattribut Texture2d lautet, darf depthPitch auch dann nicht verwendet werden, wenn DepthPitch nicht mit dem Wert 0 (Null) versehen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows Vista. |
| Kopfzeile | d3d10umddi.h (include D3d10umddi.h) |