IDirect3DDevice9::GetStreamSource-Methode (d3d9.h)

Artikel
08/23/2023

Ruft einen Scheitelpunktpuffer ab, der an den angegebenen Datenstrom gebunden ist.

Syntax

HRESULT GetStreamSource(
  UINT                   StreamNumber,
  IDirect3DVertexBuffer9 **ppStreamData,
  UINT                   *pOffsetInBytes,
  UINT                   *pStride
);

Parameter

StreamNumber

Typ: [in] UINT

Gibt den Datenstrom im Bereich von 0 bis zur maximalen Anzahl von Streams minus 1 an.

ppStreamData

Typ: [in, out] IDirect3DVertexBuffer9**

Adresse eines Zeigers auf eine IDirect3DVertexBuffer9-Schnittstelle , die den zurückgegebenen Vertexpuffer darstellt, der an den angegebenen Datenstrom gebunden ist.

pOffsetInBytes

Typ: [out]UINT*

Zeiger, der den Offset vom Anfang des Datenstroms bis zum Anfang der Vertexdaten enthält. Der Offset wird in Bytes gemessen. Siehe Hinweise.

pStride

Typ: [out] UINT*

Zeiger auf einen zurückgegebenen Schritt der Komponente in Bytes. Siehe Hinweise.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Hinweise

Ein Stream ist als einheitliches Array von Komponentendaten definiert, wobei jede Komponente aus einem oder mehreren Elementen besteht, die eine einzelne Entität darstellen, z. B. Position, Normal, Farbe usw.

Wenn ein FVF-Vertex-Shader verwendet wird, muss der Schritt des Vertexstreams mit der Scheitelpunktgröße übereinstimmen, die aus dem FVF berechnet wird. Wenn eine Deklaration verwendet wird, sollte der Stride größer oder gleich der aus der Deklaration berechneten Streamgröße sein.

Durch Aufrufen dieser Methode wird die interne Verweisanzahl auf der IDirect3DVertexBuffer9-Schnittstelle erhöht. Fehler beim Aufrufen von IUnknown::Release nach Abschluss der Verwendung dieser IDirect3DVertexBuffer9-Schnittstelle führt zu einem Speicherverlust.