D3DHAL_DP2SETSTREAMSOURCEUM Struktur (d3dhal.h)

Nur DirectX 8.0 und höhere Versionen.

Die D3DHAL_DP2SETSTREAMSOURCEUM-Struktur wird verwendet, um eine Vertexstreamquelle an einen Benutzerspeicherpuffer für D3dDrawPrimitives2 zu binden.

Syntax

typedef struct _D3DHAL_DP2SETSTREAMSOURCEUM {
  DWORD dwStream;
  DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCEUM;

Member

dwStream

Gibt den gebundenen Stream an. Bei DirectX 8.0 ist es immer 0.

dwStride

Gibt die Scheitelpunktgröße in Bytes an.

Hinweise

Neben der Bindung eines Datenstroms an einen Vertexpuffer ist es möglich, dass die Vertexdaten von Stream Zero in einem UM-Puffer (User Memory) bereitgestellt werden. In diesem Fall wird ein anderes DP2-Token verwendet, um den Treiber über die Streambindung zu benachrichtigen. Dieses Token ist D3DDP2OP_SETSTREAMSOURCEUM.

DirectX 8.0 unterstützt nicht mehrere Vertexdatenströme mit vom Benutzer bereitgestellten Puffern anstelle von Vertexpuffern. Darüber hinaus ist es nicht möglich, Benutzerspeicherpuffer mit Vertexpuffern zu mischen. Wenn ein Benutzerspeicherpuffer bereitgestellt wird, wird garantiert, dass er Stream null ist und der einzige Stream ist, auf den nachfolgende Zeichnungsgrundtypen zugreifen sollten. Es ist möglich, dass andere Datenströme zu dem Zeitpunkt, zu dem ein Benutzerspeicherpuffer an den Stream gebunden ist, über Nicht-NULL-Vertexpuffer gebunden sind. Diese anderen Streams müssen jedoch vom Treiber und der Hardware ignoriert werden.

Der tatsächliche Benutzerspeicherzeiger auf die Vertexdaten sollte aus der D3DHAL_DRAWPRIMITIVES2DATA extrahiert werden, die beim Zeichnen von Grundtypen übergeben wird.

Anforderungen

Anforderung	Wert
Header	d3dhal.h (einschließlich D3dhal.h)

Weitere Informationen

D3DDP2OP_SETSTREAMSOURCEUM

D3DHAL_DP2SETSTREAMSOURCE

D3DHAL_DRAWPRIMITIVES2DATA

D3dDrawPrimitives2