Metodo IDirect3DDevice9::GetStreamSource (d3d9.h)

Articolo
03/05/2024

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

Sintassi

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

Parametri

StreamNumber

Tipo: [in] UINT

Specifica il flusso di dati, compreso 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 dei vertici restituito associato al flusso di dati specificato.

pOffsetInBytes

Tipo: [out]UINT*

Puntatore contenente l'offset dall'inizio del flusso all'inizio dei dati dei vertici. 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 viene 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 dei componenti, in cui ogni componente è costituito da uno o più elementi che rappresentano una singola entità, ad esempio posizione, normale, colore e così via.

Quando si usa un vertex shader FVF, lo stride del flusso dei vertici deve corrispondere alle dimensioni del vertice, calcolate dal 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 . Se non si chiama IUnknown::Release al termine dell'uso di questa interfaccia IDirect3DVertexBuffer9 , si verifica una perdita di memoria.