structure D3DHAL_DP2SETSTREAMSOURCE (d3dhal.h)

DirectX 8.0 et versions ultérieures uniquement.

La structure D3DHAL_DP2SETSTREAMSOURCE est utilisée pour lier une source de flux de vertex à une mémoire tampon de vertex pour D3dDrawPrimitives2.

Syntaxe

typedef struct _D3DHAL_DP2SETSTREAMSOURCE {
  DWORD dwStream;
  DWORD dwVBHandle;
  DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCE;

Membres

dwStream

Spécifie le flux lié. Il a une valeur comprise entre zéro et le nombre maximal de flux spécifiés par le pilote.

dwVBHandle

Spécifie le handle de mémoire tampon de vertex. Il est légal que le handle de mémoire tampon de vertex soit égal à zéro, auquel cas le flux n’est plus lié à une mémoire tampon de vertex.

dwStride

Spécifie la taille de vertex en octets.

Remarques

Un pilote est averti de la liaison d’une mémoire tampon de vertex à un flux particulier via un nouveau jeton DP2, D3DDP2OP_SETSTREAMSOURCE.

Le runtime de débogage valide que dwStream se trouve dans la plage légale, mais que la version commerciale ne le fait pas, la validation doit donc être présente dans le pilote. DirectX 8.0 ne définit pas le comportement du pilote ou du matériel dans le cas d’erreur où l’index de flux donné est supérieur au flux maximal pris en charge par le matériel (tel qu’indiqué via MaxStreams dans D3DCAPS8) au-delà de l’exigence que la combinaison de pilotes et de matériel ne soit pas défectueuse ou bloquée dans ce cas et que, lors de la restauration d’un état correct, la combinaison de pilotes et de matériel doit continuer à fonctionner normalement. Les versions de débogage de votre pilote d’affichage doivent afficher des messages dans le flux de sortie de débogage indiquant quand ce problème a été détecté.

Le runtime ne valide pas que les flux accessibles par le nuanceur de vertex actuel ne sont pas NULL. Il incombe au rédacteur du pilote de s’assurer que le pilote/le matériel ne se bloque pas lorsque ce cas d’erreur se produit. Les versions de débogage de votre pilote d’affichage doivent afficher des messages dans le flux de sortie de débogage pour indiquer quand ce problème a été détecté.

Une seule source de flux est définie par une structure de D3DHAL_DP2COMMAND. Autrement dit, le champ wStateCount du D3DHAL_DP2COMMAND est toujours un lorsque bCommand est D3DDP2OP_SETSTREAMSOURCE.

Exigences

Voir aussi

D3DDP2OP_SETSTREAMSOURCE

D3DHAL_DP2COMMAND

D3DHAL_DP2SETSTREAMSOURCEUM

D3dDrawPrimitives2