structure D3DHAL_DP2SETSTREAMSOURCE (d3dhal.h)

  • Article

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é par le pilote.

dwVBHandle

Spécifie la poignée 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 du 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 pas la version commerciale. 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 (comme indiqué via MaxStreams dans D3DCAPS8) au-delà de l’obligation que la combinaison pilote et matériel ne soit pas défaillante ou bloquée dans ce cas et que, en cas de restauration de l’état correct, la combinaison pilote et 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 de pilotes de s’assurer que le pilote/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 D3DHAL_DP2COMMAND . Autrement dit, le champ wStateCount du D3DHAL_DP2COMMAND en est toujours un lorsque bCommand est D3DDP2OP_SETSTREAMSOURCE.

Configuration requise

Condition requise Valeur
En-tête d3dhal.h (inclure D3dhal.h)

Voir aussi

D3DDP2OP_SETSTREAMSOURCE

D3DHAL_DP2COMMAND

D3DHAL_DP2SETSTREAMSOURCEUM

D3dDrawPrimitives2