IDCompositionEffectGroup ::SetTransform3D, méthode (dcomp.h)
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 |
Voir aussi
IDCompositionMatrixTransform3D