ID2D1Factory1 ::RegisterEffectFromStream, méthode (d2d1_1.h)
Inscrit un effet dans la fabrique instance avec la propriété XML spécifiée en tant que flux.
Syntaxe
HRESULT RegisterEffectFromStream(
[in] REFCLSID classId,
[in] IStream *propertyXml,
[in, optional] const D2D1_PROPERTY_BINDING *bindings,
UINT32 bindingsCount,
const PD2D1_EFFECT_FACTORY effectFactory
);
Paramètres
[in] classId
Type : REFCLSID
Identificateur de l’effet à enregistrer.
[in] propertyXml
Type : IStream
Liste des propriétés d’effet, des types et des métadonnées.
[in, optional] bindings
Type : const D2D1_PROPERTY_BINDING*
Tableau de propriétés et de méthodes.
Cela lie une propriété par nom à une méthode particulière implémentée par l’auteur de l’effet pour gérer la propriété. Le nom doit se trouver dans la propriétéXml correspondante.
bindingsCount
Type : UINT32
Nombre de liaisons dans le tableau de liaisons.
effectFactory
Type : PD2D1_EFFECT_FACTORY
Fabrique statique utilisée pour créer l’effet correspondant.
Valeur retournée
Type : HRESULT
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
HRESULT | Description |
---|---|
S_OK | Aucune erreur ne s'est produite. |
E_OUTOFMEMORY | Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel. |
E_INVALIDARG | Un paramètre non valide a été passé à la fonction de retour. |
Remarques
Les effets Direct2D doivent définir leurs propriétés au moment de l’inscription via le xml d’inscription. Un effet déclare plusieurs propriétés système requises et peut également déclarer des propriétés personnalisées. Pour plus d’informations sur la mise en forme du paramètre propertyXml, consultez Effets personnalisés.
RegisterEffect est à la fois atomique et compte référence. Pour annuler l’inscription d’un effet, appelez UnregisterEffect avec le classId de l’effet.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP] |
Plateforme cible | Windows |
En-tête | d2d1_1.h |
Bibliothèque | D2d1.lib |
DLL | D2d1.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour