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

Artículo
08/23/2023

Establece el objeto de efecto de transformación 3D al que se modifica la rasterización de los objetos visuales a los que se aplica este grupo de efectos.

Sintaxis

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

Parámetros

[in, optional] transform3D

Tipo: IDCompositionTransform3D*

Puntero a una interfaz IDCompositionTransform3D o a una de sus interfaces derivadas. Este parámetro puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.

Comentarios

Este método produce un error si transform3D es un puntero no válido o si el puntero no se creó mediante la misma interfaz IDCompositionDevice que este grupo de efectos. La interfaz no puede ser una implementación personalizada; solo se pueden usar interfaces creadas por Microsoft DirectComposition con este método.

Si el parámetro transform3D es NULL, el grupo de efectos no aplica ninguna transformación de perspectiva a los objetos visuales. Establecer la transformación en NULL equivale a establecer la transformación en un objeto IDCompositionMatrixTransform3D donde la matriz especificada es la matriz de identidad. Sin embargo, una aplicación debe usar una transformación NULL siempre que sea posible porque es ligeramente más rápida.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	dcomp.h
Library	Dcomp.lib
Archivo DLL	Dcomp.dll