IDCompositionDevice2::CreateMatrixTransform3D method (dcomp.h)
Creates a 3D 4-by-4 matrix transform object.
Syntax
HRESULT CreateMatrixTransform3D(
[out] IDCompositionMatrixTransform3D **matrixTransform3D
);
Parameters
[out] matrixTransform3D
Type: IDCompositionMatrixTransform3D**
The new 3D matrix transform object. This parameter must not be NULL.
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
The new 3D matrix transform has the identity matrix as its value. The identity matrix is the 4-by-4 matrix with ones on the main diagonal and zeros elsewhere, as shown in the following illustration.
![Four-by-four identity matrix](images/identity_4x4matrix.png)
When an identity transform is applied to an object, it does not change the position, shape, or size of the object. It is similar to the way that multiplying a number by one does not change the number. Any transform other than the identity transform will modify the position, shape, and/or size of objects.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8.1 [desktop apps only] |
Minimum supported server | Windows Server 2012 R2 [desktop apps only] |
Target Platform | Windows |
Header | dcomp.h |
Library | Dcomp.lib |
DLL | Dcomp.dll |