IDirect3DDevice9::GetTextureStageState method

Retrieves a state value for an assigned texture.

Syntax


HRESULT GetTextureStageState(
  [in]          DWORD                    Stage,
  [in]          D3DTEXTURESTAGESTATETYPE Type,
  [out, retval] DWORD                    *pValue
);

Parameters

Stage [in]

Type: DWORD

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

Type [in]

Type: D3DTEXTURESTAGESTATETYPE

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

pValue [out, retval]

Type: DWORD*

Pointer a variable to fill with the retrieved state value. The meaning of the retrieved value is determined by the Type parameter.

Return value

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

This method will not return device state for a device that is created using D3DCREATE_PUREDEVICE. If you want to use this method, you must create your device with any of the other flag values in D3DCREATE."

Requirements

Header

D3D9.h

Library

D3D9.lib

See also

IDirect3DDevice9
IDirect3DDevice9::SetTextureStageState
IDirect3DDevice9::GetTexture
IDirect3DDevice9::SetTexture

 

 

Show: