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

D3DHAL_DP2COMMAND

D3dDrawPrimitives2