IDirect3DDevice::SetMatrix

HRESULT SetMatrix(D3DMATRIXHANDLE d3dMatHandle,

LPD3DMATRIX lpD3DMatrix);

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

·Returns D3D_OK if successful, or an error otherwise, such as DDERR_INVALIDPARAMS.

d3dMatHandle

Matrix handle to be set.

lpD3DMatrix

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

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