IDCompositionMatrixTransform3D::SetMatrix method (dcomp.h)

Article
02/22/2024

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

Syntax

HRESULT SetMatrix(
  [ref] const D3DMATRIX & matrix
);

Parameters

[ref] 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

Requirement	Value
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