IDCompositionEffectGroup ::SetTransform3D, méthode (dcomp.h)

Article
03/02/2024

Définit l’objet d’effet de transformation 3D qui modifie la rastérisation des visuels auxquels ce groupe d’effets est appliqué.

Syntaxe

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

Paramètres

[in, optional] transform3D

Type : IDCompositionTransform3D*

Pointeur vers une interface IDCompositionTransform3D ou l’une de ses interfaces dérivées. Ce paramètre peut être NULL.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Remarques

Cette méthode échoue si transform3D est un pointeur non valide, ou si le pointeur n’a pas été créé par la même interface IDCompositionDevice que ce groupe d’effets. L’interface ne peut pas être une implémentation personnalisée ; seules les interfaces créées par Microsoft DirectComposition peuvent être utilisées avec cette méthode.

Si le paramètre transform3D a la valeur NULL, le groupe d’effets n’applique aucune transformation de perspective aux visuels. Définir la transformation sur NULL revient à définir la transformation sur un objet IDCompositionMatrixTransform3D où la matrice spécifiée est la matrice d’identité. Toutefois, une application doit utiliser une transformation NULL dans la mesure du possible, car elle est légèrement plus rapide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dcomp.h
Bibliothèque	Dcomp.lib
DLL	Dcomp.dll