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

Die Deptch-Pitch, Breite oder physische Größe (in Bytes) 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 Tiefenslic 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, ist es hilfreich, sich alle Ressourcen wie in den folgenden beiden Beispielen als dreidimensional zu betrachten:

  • Wenn das Ressourcenattribute Buffer oder Texture1D ist und 8 Bytes enthält, wären die entsprechenden Werte für RowPitch und DepthPitch 8 oder mehr.
  • Wenn das Resource-Attribut Texture2d ist, darf DepthPitch auch dann nicht verwendet werden, wenn DepthPitch nicht der Wert 0 zugewiesen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows Vista.
Kopfzeile d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen

ResourceMap