The D3DDDIARG_TEXTURESTAGESTATE structure describes how to update a texture at a particular stage in a multiple-texture group.


  UINT                        Stage;
  UINT                        Value;



[in] The stage in a multiple-texture group that indicates the texture to be updated. This member can be an integer in the range from 0 through 7, with the highest numbered texture being closest to the frame buffer.


[in] A D3DDDITEXTURESTAGESTATETYPE-typed value that indicates the texture state to be updated.

Microsoft DirectX 9.0 and later applications can use values in the D3DSAMPLERSTATETYPE enumeration type to control the characteristics of sampler texture-related render states. In DirectX 8.0 and earlier, these sampler states were included in the D3DTEXTURESTAGESTATETYPE enumeration. The runtime maps sampler states (D3DSAMP_Xxx) to D3DDDITSS_Xxx values so that drivers are not required to process sampler states. For more information about D3DTEXTURESTAGESTATETYPE and D3DSAMPLERSTATETYPE, see the DirectX SDK documentation.

For a definition of each value, see the corresponding value of D3DTEXTURESTAGESTATETYPE or D3DSAMPLERSTATETYPE.

The following texture states are used exclusively by user-mode display drivers for texture colorkeying:

Value Meaning
D3DDDITSS_DISABLETEXTURECOLORKEY (33) Disable the current texture's colorkey. The Value member is set to TRUE to disable.
D3DDDITSS_TEXTURECOLORKEYVAL (34) Update the colorkey for the current texture. The Value member is set to the colorkey value.


[in] The value to which the driver should update the texture state that is identified by the Stage and State members. For more information about values that can be updated for each texture state, see the definitions of the corresponding texture state in the D3DTEXTURESTAGESTATETYPE or D3DSAMPLERSTATETYPE enumeration type in the DirectX SDK documentation.


Windows version Available in Windows Vista and later versions of the Windows operating systems. Available in Windows Vista and later versions of the Windows operating systems.
Header d3dumddi.h (include D3dumddi.h)

See Also