Метод IDCompositionEffectGroup::SetTransform3D (dcomp.h)

Статья
08/23/2023

Задает объект эффекта трехмерного преобразования, который изменяет растеризацию визуальных элементов, к которым применяется эта группа эффектов.

Синтаксис

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

Параметры

[in, optional] transform3D

Тип: IDCompositionTransform3D*

Указатель на интерфейс IDCompositionTransform3D или один из его производных интерфейсов. Этот параметр может принимать значение NULL.

Возвращаемое значение

Тип: HRESULT

Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .

Этот метод завершается ошибкой, если transform3D является недопустимым указателем или если указатель не был создан тем же интерфейсом IDCompositionDevice , что и эта группа эффектов. Интерфейс не может быть пользовательской реализацией; С этим методом можно использовать только интерфейсы, созданные Microsoft DirectComposition.

Если параметр transform3D имеет значение NULL, группа эффектов не применяет преобразования перспективы к визуальным элементам. Установка для преобразования значения NULL эквивалентна установке преобразования на объект IDCompositionMatrixTransform3D , где указанная матрица является матрицей идентификации. Однако приложение должно по возможности использовать преобразование NULL, так как оно немного быстрее.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	dcomp.h
Библиотека	Dcomp.lib
DLL	Dcomp.dll