Méthode IDirect3DDevice9 ::GetStreamSource (d3d9.h)

Article
03/02/2024

Récupère une mémoire tampon de vertex liée au flux de données spécifié.

Syntaxe

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

Paramètres

StreamNumber

Type : [in] UINT

Spécifie le flux de données, entre 0 et le nombre maximal de flux moins un.

ppStreamData

Type : [in, out] IDirect3DVertexBuffer9**

Adresse d’un pointeur vers une interface IDirect3DVertexBuffer9 , représentant le tampon de vertex retourné lié au flux de données spécifié.

pOffsetInBytes

Type : [out]UINT*

Pointeur contenant le décalage entre le début du flux et le début des données de vertex. Le décalage est mesuré en octets. Consultez la section Notes.

pStride

Type : [out] UINT*

Pointeur vers une foulée retournée du composant, en octets. Consultez la section Notes.

Valeur de retour

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL.

Remarques

Un flux est défini comme un tableau uniforme de données de composant, où chaque composant se compose d’un ou plusieurs éléments représentant une seule entité, comme la position, la normale, la couleur, etc.

Lorsqu’un nuanceur de vertex FVF est utilisé, la foulée du flux de vertex doit correspondre à la taille du vertex, calculée à partir de la FVF. Lorsqu’une déclaration est utilisée, la foulée doit être supérieure ou égale à la taille de flux calculée à partir de la déclaration.

L’appel de cette méthode augmente le nombre de références internes sur l’interface IDirect3DVertexBuffer9 . L’échec de l’appel de IUnknown ::Release lorsque vous avez terminé d’utiliser cette interface IDirect3DVertexBuffer9 entraîne une fuite de mémoire.