IDCompositionMatrixTransform::SetMatrixElement(int,int,float) method (dcomp.h)

Changes the value of one element of the matrix of this transform.

Syntax

HRESULT SetMatrixElement(
  [in] int   row,
  [in] int   column,
  [in] float value
);

Parameters

[in] row

Type: int

The row index of the element to change. This value must be between 0 and 2, inclusive.

[in] column

Type: int

The column index of the element to change. This value must be between 0 and 1, inclusive.

[in] value

Type: float

The new value of the specified element.

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 the value parameter is NaN, positive infinity, or negative infinity.

If the specified element was previously animated, this method removes the animation and sets the element 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

See also

IDCompositionMatrixTransform