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

Artigo
02/29/2024

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