Méthode IDirect3DDevice9 ::D rawPrimitiveUP (d3d9helper.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9helper.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |