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

Weitere Informationen

ResourceMap