D3DDDIARG_TEXTURESTAGESTATE structure (d3dumddi.h)
The D3DDDIARG_TEXTURESTAGESTATE structure describes how to update a texture at a particular stage in a multiple-texture group.
Syntax
typedef struct _D3DDDIARG_TEXTURESTAGESTATE {
[in] UINT Stage;
[in] D3DDDITEXTURESTAGESTATETYPE State;
[in] UINT Value;
} D3DDDIARG_TEXTURESTAGESTATE;
Members
[in] Stage
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] State
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 Valuemember is set to the colorkey value. |
[in] Value
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Header | d3dumddi.h (include D3dumddi.h) |