IDirect3DDevice3::GetTexture

The IDirect3DDevice3::GetTexture method retrieves a texture assigned to a given stage for a device.

HRESULT  GetTexture( 
  DWORD dwStage,
  LPDIRECT3DTEXTURE2 * lplpTexture
);

Parameters

dwStage
Stage identifier of the texture to 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.
lplpTexture
Address of a variable that will be filled with a pointer to the specified texture's IDirect3DTexture2 interface if the call succeeds.

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::SetTexture, IDirect3DDevice3::GetTextureStageState, IDirect3DDevice3::SetTextureStageState, Textures