IDirect3DDevice3::GetTextureStageState

The IDirect3DDevice3::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 will be retrieved. Stage identifiers are zero-based. Currently, devices can have up to 8 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 that will 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 may be one of the following values:

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

Remarks

This method was introduced with the IDirect3DDevice3 interface.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in d3d.h.
  Import Library: Use ddraw.lib.

See Also

IDirect3DDevice3::SetTextureStageState, IDirect3DDevice3::GetTexture, IDirect3DDevice3::SetTexture, Textures