structure D3DHAL_DP2TEXTURESTAGESTATE (d3dhal.h)
Une ou plusieurs structures D3DHAL_DP2TEXTURESTAGESTATE sont analysées à partir de la mémoire tampon de commande par le rappel D3dDrawPrimitives2 lorsque le membre bCommand de la structure D3DHAL_DP2COMMAND est défini sur D3DDP2OP_TEXTURESTAGESTATE et est utilisé pour définir l’état d’étape de texture approprié.
Syntaxe
typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
WORD wStage;
WORD TSState;
DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;
Membres
wStage
Identifie l’étape de texture où mettre à jour l’état de texture. Ce membre peut être un entier compris entre 0 et 7, la texture numérotée la plus élevée étant la plus proche de la mémoire tampon d’images.
TSState
Spécifie une valeur énumérée D3DTEXTURESTAGESTATETYPE qui spécifie l’état de texture à mettre à jour. Les applications DirectX 9.0 et ultérieures peuvent utiliser des valeurs dans l’énumération D3DSAMPLERSTATETYPE pour contrôler les caractéristiques des états de rendu liés à la texture de l’échantillonneur. Dans DirectX 8.0 et versions antérieures, ces états d’échantillonneur ont été inclus dans l’énumération D3DTEXTURESTAGESTATETYPE. Le runtime mappe les états de l’échantillonneur en mode utilisateur (D3DSAMP_Xxx) aux valeurs D3DTSS_xxx afin que les pilotes ne soient pas requis pour traiter les états d’échantillonneur en mode utilisateur. Pour plus d’informations sur les D3DTEXTURESTAGESTATETYPE et les D3DSAMPLERSTATETYPE, consultez la documentation du Kit de développement logiciel (SDK) DirectX.
dwValue
Spécifie la valeur vers laquelle le pilote doit mettre à jour l’état de texture identifié par TSState.
Remarques
D3dDrawPrimitives2 doit traiter structures wStateCount D3DHAL_DP2TEXTURESTAGESTATE à partir de la mémoire tampon de commandes. La valeur de wStateCount est spécifiée dans la structure D3DHAL_DP2COMMAND.
Pour chaque structure de D3DHAL_DP2TEXTURESTAGESTATE, D3dDrawPrimitives2 doit mettre à jour l’état de texture interne du pilote associé à la texture à dwStage pour refléter la nouvelle valeur basée sur TSState.
Les pilotes qui ne prennent pas en charge la multitexturing doivent implémenter la prise en charge de l’étape de texture 0 uniquement.
La figure suivante montre une partie d’un exemple de mémoire tampon de commande contenant une commande D3DDP2OP_TEXTURESTAGESTATE et trois structures D3DHAL_DP2TEXTURESTAGESTATE. Le pilote doit mettre à jour les étapes zéro et trois de son état d’étape de texture privée en conséquence.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | d3dhal.h (include D3dhal.h) |
Voir aussi
D3DDP2OP_TEXTURESTAGESTATE