IDCompositionMatrixTransform3D::SetMatrix method

Changes all values of the matrix of this 3D transformation effect.

Syntax

HRESULT SetMatrix(
  const D3DMATRIX & matrix
);

Parameters

matrix

Type: const D3DMATRIX

The new matrix for this 3D transformation effect.

Return Value

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See DirectComposition Error Codes for a list of error codes.

Remarks

This method fails if any of the matrix values are NaN, positive infinity, or negative infinity.

If any of the matrix elements were previously animated, this method removes the animations and sets the elements to the specified static value.

Requirements

   
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header dcomp.h
Library Dcomp.lib
DLL Dcomp.dll

See Also

IDCompositionMatrixTransform3D