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 sont utilisées 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 la phase de texture dans laquelle mettre à jour l’état de texture. Ce membre peut être un entier de la plage 0 à 7, la texture numérotée la plus élevée étant la plus proche de la mémoire tampon de trame.
TSState
Spécifie une D3DTEXTURESTAGESTATETYPE valeur énumérée 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’échantillonnage ont été inclus dans l’énumération D3DTEXTURESTAGESTATETYPE. Le runtime mappe les états de l’échantillonneur en mode utilisateur (D3DSAMP_Xxx) aux valeurs du mode noyau D3DTSS_Xxx afin que les pilotes ne soient pas obligés de traiter les états de l’é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 les structures wStateCount D3DHAL_DP2TEXTURESTAGESTATE à partir de la mémoire tampon de commande. La valeur de wStateCount est spécifiée dans la structure D3DHAL_DP2COMMAND.
Pour chaque structure D3DHAL_DP2TEXTURESTAGESTATE, D3dDrawPrimitives2 doit mettre à jour l’état de texture interne du pilote associé à la texture au niveau de dwStage pour refléter la nouvelle valeur basée sur TSState.
Les pilotes qui ne prennent pas en charge le 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 phases zéro et trois de son état d’étape de texture privée en conséquence.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | d3dhal.h (inclure D3dhal.h) |
Voir aussi
D3DDP2OP_TEXTURESTAGESTATE