Méthode IDirect3DDevice9 ::D rawPrimitiveUP (d3d9helper.h)

Article
02/26/2024

Restitue les données spécifiées par un pointeur de mémoire utilisateur sous la forme d’une séquence de primitives géométriques du type spécifié.

Syntaxe

HRESULT DrawPrimitiveUP(
  [in] D3DPRIMITIVETYPE PrimitiveType,
  [in] UINT             PrimitiveCount,
  [in] const void       *pVertexStreamZeroData,
  [in] UINT             VertexStreamZeroStride
);

Paramètres

[in] PrimitiveType

Type : D3DPRIMITIVETYPE

Membre du D3DPRIMITIVETYPE type énuméré, décrivant le type de primitive à restituer.

[in] PrimitiveCount

Type : UINT

Nombre de primitives à afficher. Le nombre maximal de primitives autorisées est déterminé en vérifiant le membre MaxPrimitiveCount de la structure D3DCAPS9 .

[in] pVertexStreamZeroData

Type : const void*

Pointeur de mémoire utilisateur vers les données de vertex.

[in] VertexStreamZeroStride

Type : UINT

Nombre d’octets de données pour chaque sommet. Cette valeur peut ne pas être 0.

Valeur retournée

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

Cette méthode est destinée à être utilisée dans les applications qui ne peuvent pas stocker leurs données de vertex dans des mémoires tampons de vertex. Cette méthode ne prend en charge qu’un seul flux de vertex. L’effet de cet appel est d’utiliser le pointeur de données de vertex et la foulée fournis pour le flux de vertex 0. Il n’est pas valide que la déclaration du nuanceur de vertex actuel fasse référence à des flux de vertex autres que le flux 0.

Après un appel IDirect3DDevice9 ::D rawPrimitiveUP , les paramètres de flux 0, référencés par IDirect3DDevice9 ::GetStreamSource, sont définis sur NULL.

Les données de vertex passées à IDirect3DDevice9 ::D rawPrimitiveUP n’ont pas besoin de persister après l’appel. Direct3D termine son accès à ces données avant de revenir de l’appel.

Lors de la conversion d’une application héritée en Direct3D 9, vous devez ajouter un appel à IDirect3DDevice9 ::SetFVF pour utiliser le pipeline de fonction fixe, ou à IDirect3DDevice9 ::SetVertexDeclaration pour utiliser un nuanceur de vertex avant d’effectuer des appels Draw.