D3DHAL_DP2SETSTREAMSOURCE Struktur (d3dhal.h)

  • Artikel

Nur DirectX 8.0 und höhere Versionen.

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

Syntax

typedef struct _D3DHAL_DP2SETSTREAMSOURCE {
  DWORD dwStream;
  DWORD dwVBHandle;
  DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCE;

Member

dwStream

Gibt den gebundenen Stream an. Es hat einen Wert zwischen 0 und der maximalen Anzahl von Streams, die vom Treiber angegeben werden.

dwVBHandle

Gibt den Scheitelpunktpufferhandle an. Es ist legal, dass das Vertexpufferhandle 0 ist. In diesem Fall ist der Stream nicht mehr an einen Vertexpuffer gebunden.

dwStride

Gibt die Scheitelpunktgröße in Bytes an.

Hinweise

Ein Treiber wird über die Bindung eines Vertexpuffers an einen bestimmten Stream über ein neues DP2-Token D3DDP2OP_SETSTREAMSOURCE benachrichtigt.

Die Debuglaufzeit überprüft, ob dwStream innerhalb des gesetzlichen Bereichs liegt, die Einzelhandelsversion jedoch nicht. Daher muss eine Überprüfung im Treiber vorhanden sein. DirectX 8.0 definiert nicht das Verhalten des Treibers oder der Hardware in dem Fehlerfall, in dem der angegebene Streamindex größer als der maximale von der Hardware unterstützte Datenstrom ist (wie über MaxStreams in D3DCAPS8 gemeldet), außer dass die Treiber- und Hardwarekombination in diesem Fall nicht fehlerhaft oder hängen bleibt und dass bei Wiederherstellung des korrekten Zustands die Kombination von Treiber und Hardware weiterhin normal funktionieren sollte. Debugversionen Ihres Anzeigetreibers sollten Meldungen im Debugausgabestream anzeigen, die angeben, wann dieses Problem erkannt wurde.

Die Runtime überprüft nicht, ob die Streams, auf die der aktuelle Vertex-Shader zugreift, nicht NULL sind. Es liegt in der Verantwortung des Treiberschreibers, sicherzustellen, dass der Treiber/die Hardware nicht abstürzt, wenn dieser Fehlerfall auftritt. Debugversionen Ihres Anzeigetreibers sollten Meldungen im Debugausgabestream anzeigen, um anzugeben, wann dieses Problem erkannt wurde.

Nur eine einzelne Streamquelle wird von einer D3DHAL_DP2COMMAND-Struktur festgelegt. Das heißt, das wStateCount-Feld des D3DHAL_DP2COMMAND ist immer eins, wenn bCommand D3DDP2OP_SETSTREAMSOURCE ist.

Anforderungen

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

Weitere Informationen

D3DDP2OP_SETSTREAMSOURCE

D3DHAL_DP2COMMAND

D3DHAL_DP2SETSTREAMSOURCEUM

D3dDrawPrimitives2