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
IDCompositionMatrixTransform3D