IDirect3DDevice7::GetMaterial

The IDirect3DDevice7::GetMaterial method retrieves the current material properties for the device.

HRESULT GetMaterial( 
  LPD3DMATERIAL7 lpMaterial 
); 

Parameters

lpMaterial

Address of a D3DMATERIAL7 structure to be filled with the currently set material properties.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value is an error. The method returns DDERR_INVALIDPARAMS if the lpMaterial parameter is invalid.

Remarks

This method was introduced with the IDirect3DDevice7 interface.

Unlike its predecessors, the IDirect3DDevice7 interface does not use material handles. This method, and its use of the D3DMATERIAL7 structure to describe material properties, replaces the material-handle semantics used by previous versions of the device interface.

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::SetMaterial