IDirect3DDevice7::GetTextureStageState

The IDirect3DDevice7::GetTextureStageState method retrieves a state value for a currently assigned texture.

HRESULT GetTextureStageState(
  DWORD   dwStage,
  D3DTEXTURESTAGESTATETYPE dwState,
  LPDWORD lpdwValue
); 

Parameters

dwStage

Stage identifier of the texture for which the state is retrieved. Stage identifiers are zero-based. Currently, devices can have up to eight set textures, so the maximum allowable value allowed for dwStage is 7.

dwState

Texture state to be retrieved. This parameter can be any member of the D3DTEXTURESTAGESTATETYPE enumerated type.

lpdwValue

Address of a variable to be filled with the retrieved state value. The meaning of the retrieved value is determined by the dwState parameter.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values:

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.

See Also

IDirect3DDevice7::SetTextureStageState, IDirect3DDevice7::GetTexture, IDirect3DDevice7::SetTexture, Textures