Interface IMFVideoProcessor (evr9.h)
Contrôle le traitement vidéo dans le convertisseur vidéo amélioré (EVR). Les opérations contrôlées via cette interface incluent l’ajustement des couleurs (ProcAmp), les filtres de bruit et les filtres de détails.
Le mélangeur EVR implémente cette interface. Pour obtenir un pointeur vers l’interface, appelez IMFGetService::GetService. L’identificateur de service est guid MR_VIDEO_MIXER_SERVICE. Appelez GetService sur l’un des objets suivants :
- Session multimédia (si la topologie contient un instance de l’EVR).
- Récepteur de média EVR.
- Filtre DIRECTShow EVR.
- Mélangeur EVR.
Héritage
L’interface IMFVideoProcessor hérite de l’interface IUnknown . IMFVideoProcessor a également les types de membres suivants :
Méthodes
L’interface IMFVideoProcessor utilise ces méthodes.
| IMFVideoProcessor::GetAvailableVideoProcessorModes Récupère les modes de processeur vidéo pris en charge par le pilote vidéo. |
| IMFVideoProcessor::GetBackgroundColor Récupère la couleur d’arrière-plan du rectangle de composition. La couleur d’arrière-plan est utilisée pour le boîte aux lettres de l’image vidéo. |
| IMFVideoProcessor::GetFilteringRange Récupère la plage de valeurs pour un paramètre de filtre d’image spécifié. |
| IMFVideoProcessor::GetFilteringValue Récupère le paramètre actuel d’un filtre d’image. |
| IMFVideoProcessor::GetProcAmpRange Récupère la plage de valeurs d’un paramètre d’ajustement de couleur (ProcAmp). |
| IMFVideoProcessor::GetProcAmpValues Récupère les paramètres actuels pour un ou plusieurs paramètres d’ajustement de couleur (ProcAmp). |
| IMFVideoProcessor::GetVideoProcessorCaps Récupère les fonctionnalités d’un mode processeur vidéo. |
| IMFVideoProcessor::GetVideoProcessorMode Récupère le mode de processeur vidéo préféré de l’application. Pour définir le mode préféré, appelez IMFVideoProcessor::SetVideoProcessorMode. |
| IMFVideoProcessor::SetBackgroundColor Définit la couleur d’arrière-plan du rectangle de composition. La couleur d’arrière-plan est utilisée pour le boîte aux lettres de l’image vidéo. |
| IMFVideoProcessor::SetFilteringValue Définit un paramètre pour un filtre d’image. |
| IMFVideoProcessor::SetProcAmpValues Définit un ou plusieurs paramètres d’ajustement de couleur (ProcAmp). |
| IMFVideoProcessor::SetVideoProcessorMode Définit le mode de processeur vidéo préféré. L’EVR tente d’utiliser ce mode au démarrage de la lecture. |
Notes
Cette interface permet d’accéder aux fonctionnalités implémentées par le pilote graphique. Le pilote fournit un ou plusieurs modes de processeur vidéo, qui sont identifiés par le GUID. Chaque mode a son propre ensemble de fonctionnalités. La liste des modes disponibles peut changer en fonction du type de média de la vidéo.
Pour utiliser cette interface, procédez comme suit :
- Initialisez les types de média sur les flux d’entrée EVR. (Si vous utilisez la session multimédia, cela se produit une fois la topologie résolue. Attendez que la session multimédia envoie l’événement MESessionTopologyStatus avec une valeur status de MF_TOPOSTATUS_READY.)
- Appelez IMFVideoProcessor::GetAvailableVideoProcessorModes pour obtenir la liste des modes de processeur vidéo disponibles.
- Appelez IMFVideoProcessor::GetVideoProcessorCaps pour rechercher les fonctionnalités de chaque mode de processeur vidéo.
- Appelez IMFVideoProcessor::SetVideoProcessorMode pour sélectionner un mode. Si vous ignorez cette étape, l’EVR sélectionne automatiquement un mode processeur vidéo au début de la diffusion en continu. Dans ce cas, attendez que la lecture démarre avant de passer à l’étape 5.
- Appelez IMFVideoProcessor::GetProcAmpRange et IMFVideoProcessor::GetFilteringRange pour rechercher la plage de valeurs pour les différents paramètres procAmp et filtre d’image.
- Appelez IMFVideoProcessor::SetProcAmpValues et IMFVideoProcessor::SetFilteringValue pour modifier les paramètres procAmp et de filtre d’image.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | evr9.h |