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

Changes the value of one element of the matrix of this 3D 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 3, inclusive.

[in] column

Type: int

The column index of the element to change. This value must be between 0 and 3, 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

See also

IDCompositionMatrixTransform3D