Procédure : Ajouter la prise en charge de paramètre d’exécution à un XAPO
Vous pouvez ajouter la prise en charge des paramètres au moment de l’exécution à un XAPO en implémentant l’interface IXAPOParameters . La prise en charge des paramètres au moment de l’exécution permet à un XAPO de modifier son comportement en fonction des paramètres qui lui sont passés au moment de l’exécution.
Suivez les étapes décrites dans procédure : créer un XAPO.
Modifiez XAPO pour qu’il dérive de CXAPOParametersBase et CXAPOBase.
Ajoutez des appels aux méthodes CXAPOParametersBase :: BeginProcess et CXAPOParametersBase :: EndProcess à l’implémentation de IXAPO ::P tionnaire.
Notes
L’ajout de ces méthodes à IXAPO ::P tionnaire permet à CXAPOParametersBase de conserver ses copies des paramètres Effects dans un état thread-safe. Appelez CXAPOParametersBase :: BeginProcess au début de IXAPO ::P tionnaireet CXAPOParametersBase :: EndProcess à la fin de IXAPO ::P tionnaire.
Ajoutez du code à l’implémentation IXAPO ::P tionnaire pour modifier son comportement en fonction des valeurs stockées par la méthode SetParameters .
Notes
L’ajout de code à la méthode IXAPO ::P tionnaire pour utiliser les paramètres spécifiés par SetParameters permet de modifier le comportement de XAPO tout au long de sa durée de vie.
Quand vous créez une instance de l’effet, allouez une mémoire tampon de trois des structures qui représenteront les paramètres de l’effet et transmettez-la au constructeur CXAPOParametersBase .
Notes
L’instance CXAPOParametersBase utilise en interne cette mémoire tampon pour gérer les paramètres d’effet qui lui sont passés quand vous appelez SetParameters. Vous devez initialiser tous les blocs de paramètres de processus dans pParameterBlocks à la même valeur par défaut avant d’appeler l’une des méthodes IXAPO ::P tionnaire, IXAPOParameters :: GetParameterset IXAPOParameters :: SetParameters . En général, cette initialisation est gérée dans IXAPO :: Initialize ou dans IXAPO :: LockForProcess.