Sets the 3D transformation effect object that modifies the rasterization of the visuals that this effect group is applied to.
HRESULT SetTransform3D( IDCompositionTransform3D *transform3D );
Pointer to an IDCompositionTransform3D interface or one of its derived interfaces. This parameter can be NULL.
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.
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.
|Minimum supported client||Windows 8 [desktop apps only]|
|Minimum supported server||Windows Server 2012 [desktop apps only]|