IDCompositionDevice::CreateTransform3DGroup method (dcomp.h)

Article
02/22/2024

Creates a 3D transform group object that holds an array of 3D transform objects.

Syntax

HRESULT CreateTransform3DGroup(
  [in]  IDCompositionTransform3D **transforms3D,
  [in]  UINT                     elements,
  [out] IDCompositionTransform3D **transform3DGroup
);

Parameters

[in] transforms3D

Type: IDCompositionTransform3D**

An array of 3D transform objects that make up this transform group.

[in] elements

Type: UINT

The number of elements in the transforms array.

[out] transform3DGroup

Type: IDCompositionTransform3D**

The new 3D transform group 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 array entries in a 3D transform group cannot be changed. However, each transform in the array can be modified through its own property setting methods. If a transform in the array is modified, the change is reflected in the computed matrix of the transform group.

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