IDCompositionEffectGroup::SetTransform3D method (dcomp.h)

Sets the 3D transformation effect object that modifies the rasterization of the visuals that this effect group is applied to.

Syntax

HRESULT SetTransform3D(
  [in, optional] IDCompositionTransform3D *transform3D
);

Parameters

[in, optional] transform3D

Type: IDCompositionTransform3D*

Pointer to an IDCompositionTransform3D interface or one of its derived interfaces. This parameter can 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

This method fails if transform3D is an invalid pointer, or if the pointer was not created by the same IDCompositionDevice interface as this effect group. The interface cannot be a custom implementation; only interfaces created by Microsoft DirectComposition can be used with this method.

If the transform3D parameter is NULL, the effect group does not apply any perspective transformations to the visuals. Setting the transform to NULL is equivalent to setting the transform to an IDCompositionMatrixTransform3D object where the specified matrix is the identity matrix. However, an application should use a NULL transform whenever possible because it is slightly faster.

Requirements

See also

IDCompositionEffectGroup

IDCompositionMatrixTransform3D

IDCompositionRotateTransform3D

IDCompositionScaleTransform3D

IDCompositionTransform3D

IDCompositionTranslateTransform3D