Metodo IDirect3DDevice9::GetStreamSource (d3d9helper.h)

Articolo
02/26/2024

Recupera un buffer dei vertici associato al flusso di dati specificato.

Sintassi

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

Parametri

StreamNumber

Tipo: [in] UINT

Specifica il flusso di dati, nell'intervallo compreso tra 0 e il numero massimo di flussi meno uno.

ppStreamData

Tipo: [in, out] IDirect3DVertexBuffer9**

Indirizzo di un puntatore a un'interfaccia IDirect3DVertexBuffer9 che rappresenta il buffer del vertice restituito associato al flusso di dati specificato.

OffsetInBytes

Tipo: [out] UINT*

Puntatore contenente l'offset dall'inizio del flusso all'inizio dei dati del vertice. L'offset viene misurato in byte. Vedere la sezione Osservazioni.

pStride

Tipo: [out] UINT*

Puntatore a uno stride restituito del componente, in byte. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.

Commenti

Un flusso viene definito come una matrice uniforme di dati del componente, in cui ogni componente è costituito da uno o più elementi che rappresentano una singola entità, ad esempio posizione, normale, colore e così via.

Quando viene usato un vertex shader FVF, lo stride del flusso del vertice deve corrispondere alle dimensioni del vertice, calcolate dall'FVF. Quando viene usata una dichiarazione, lo stride deve essere maggiore o uguale alla dimensione del flusso calcolata dalla dichiarazione.

La chiamata a questo metodo aumenta il conteggio dei riferimenti interni nell'interfaccia IDirect3DVertexBuffer9 . L'errore di chiamare IUnknown::Release al termine dell'uso di questa interfaccia IDirect3DVertexBuffer9 genera una perdita di memoria.