Compartilhar via


Método IDCompositionEffectGroup::SetTransform3D (dcomp.h)

Define o objeto de efeito de transformação 3D que modifica a rasterização dos visuais aos quais esse grupo de efeitos é aplicado.

Sintaxe

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

Parâmetros

[in, optional] transform3D

Tipo: IDCompositionTransform3D*

Ponteiro para uma interface IDCompositionTransform3D ou uma de suas interfaces derivadas. Este parâmetro pode ser NULL.

Retornar valor

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Confira Códigos de erro do DirectComposition para obter uma lista de códigos de erro.

Comentários

Esse método falhará se transform3D for um ponteiro inválido ou se o ponteiro não tiver sido criado pela mesma interface IDCompositionDevice que esse grupo de efeitos. A interface não pode ser uma implementação personalizada; somente interfaces criadas pelo Microsoft DirectComposition podem ser usadas com esse método.

Se o parâmetro transform3D for NULL, o grupo de efeitos não aplicará nenhuma transformação de perspectiva aos visuais. Definir a transformação como NULL é equivalente a definir a transformação para um objeto IDCompositionMatrixTransform3D em que a matriz especificada é a matriz de identidade. No entanto, um aplicativo deve usar uma transformação NULL sempre que possível porque é um pouco mais rápido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dcomp.h
Biblioteca Dcomp.lib
DLL Dcomp.dll

Confira também

IDCompositionEffectGroup

IDCompositionMatrixTransform3D

IDCompositionRotateTransform3D

IDCompositionScaleTransform3D

IDCompositionTransform3D

IDCompositionTranslateTransform3D