Platform SDK: DirectX

D3DXMatrixInverse

The D3DXMatrixInverse function calculates the inverse of the given matrix.

D3DXMATRIX* D3DXMatrixInverse(
  D3DXMATRIX* pOut,
  float* pfDeterminant,
  const D3DXMATRIX* pM
); 

Parameters

pOut
A pointer to the D3DXMATRIX structure that is the result of the operation.
pfDeterminant
After this function returns, this parameter points to a float value that is the determinant of the given matrix, pM.
pM
A pointer to the source D3DXMATRIX structure.

Return Values

A pointer to a D3DXMATRIX structure that is the inverse of the given matrix.

Remarks

Matrix inversion may fail, in which case NULL will be returned by the D3DXMatrixInverse function. Note that the determinant of pM is returned if the pfDeterminant parameter is non-NULL.

The return value for this function is the same value returned in the pOut parameter. In this way, the D3DXMatrixInverse function can be used as a parameter for another function.

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 d3dxmath.h.
  Library: Use d3dx.lib.