IDirect3DDevice::SetMatrix

The IDirect3DDevice::SetMatrix method applies a matrix to a matrix handle. This matrix handle must have been created by using the IDirect3DDevice::CreateMatrix method.

HRESULT SetMatrix(
  D3DMATRIXHANDLE d3dMatHandle,  
  LPD3DMATRIX lpD3DMatrix        
);
 

Parameters

d3dMatHandle

Matrix handle to be set.

lpD3DMatrix

Address of a D3DMATRIX structure that describes the matrix to be set.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value is an error, such as DDERR_INVALIDPARAMS.

Remarks

Transformations inside the execute buffer include a handle to a matrix. The IDirect3DDevice::SetMatrix method enables an application to change this matrix without having to lock and unlock the execute buffer.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in ddraw.h.
  Import Library: Use ddraw.lib.

See Also

IDirect3DDevice::CreateMatrix, IDirect3DDevice::GetMatrix, IDirect3DDevice::DeleteMatrix