D3D11_MAPPED_SUBRESOURCE-Struktur (d3d11.h)

  • Artikel

Bietet Zugriff auf Unterressourcendaten.

Syntax

typedef struct D3D11_MAPPED_SUBRESOURCE {
  void *pData;
  UINT RowPitch;
  UINT DepthPitch;
} D3D11_MAPPED_SUBRESOURCE;

Member

pData

Typ: void*

Zeiger auf die Daten. Wenn ID3D11DeviceContext::Map den Zeiger bereitstellt, stellt die Laufzeit sicher, dass der Zeiger abhängig von den folgenden Featureebenen eine bestimmte Ausrichtung aufweist:

RowPitch

Typ: UINT

Der Zeilenabstand, die Breite oder die physische Größe (in Bytes) der Daten.

DepthPitch

Typ: UINT

Der Tiefenabstand, die Breite oder die physische Größe (in Bytes) der Daten.

Hinweise

Diese Struktur wird in einem Aufruf von ID3D11DeviceContext::Map verwendet.

Die Werte in diesen Membern geben An, wie viele Daten Sie anzeigen können:

  • pData zeigt auf Zeile 0 und Tiefe Slice 0.
  • RowPitch enthält den Wert, den die Runtime pData hinzufügt, um von Zeile zu Zeile zu wechseln, wobei jede Zeile mehrere Pixel enthält.
  • DepthPitch enthält den Wert, den die Runtime pData hinzufügt, um vom Tiefenslice zum Tiefenslice zu wechseln, wobei jeder Tiefenslice mehrere Zeilen enthält.
Wenn RowPitch und DepthPitch für den Ressourcentyp nicht geeignet sind, legt die Laufzeit ihre Werte möglicherweise auf 0 fest. Verwenden Sie diese Werte also nicht für das Durchlaufen von Zeilen und der Tiefe. Hier einige Beispiele:
  • Für Buffer und Texture1D weist die Laufzeit RowPitch und DepthPitch Werte zu, die nicht 0 sind. Wenn ein Puffer beispielsweise 8 Byte enthält, weist die Laufzeit RowPitch und DepthPitch Werte zu, die größer oder gleich 8 sind.
  • Für Texture2D weist die Runtime DepthPitch weiterhin einen Wert zu, der nicht 0 ist, wobei vorausgesetzt wird, dass das Feld nicht verwendet wird.
Hinweis Die Laufzeit weist RowPitch und DepthPitch möglicherweise Werte zu, die größer als erwartet sind, da zwischen Zeilen und Tiefe ein Abstand vorhanden sein kann.
 

Anforderungen

Anforderung Wert
Header d3d11.h

Weitere Informationen

Ressourcenstrukturen