IDirect3DDevice7::GetTexture

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

HRESULT GetTexture( 
  DWORD dwStage,
  LPDIRECTDRAWSURFACE7 * lplpTexture
); 

Parameters

dwStage

Stage identifier of the texture to be 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.

lplpTexture

Address of a variable to be filled with a pointer to the specified texture's IDirectDrawSurface7 interface if the call succeeds.

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:

Remarks

In the legacy IDirect3DDevice3 interface, this method accepts a pointer to an IDirect3DTexture2 interface.

Requirements

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

See Also

IDirect3DDevice7::SetTexture, IDirect3DDevice7::GetTextureStageState, IDirect3DDevice7::SetTextureStageState, Textures