Interface IMFVideoProcessor (evr9.h)

  • Article

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.
Si vous implémentez un mélangeur personnalisé pour l’EVR, le mélangeur peut éventuellement exposer cette interface en tant que service.

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 :

  1. 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.)
  2. Appelez IMFVideoProcessor::GetAvailableVideoProcessorModes pour obtenir la liste des modes de processeur vidéo disponibles.
  3. Appelez IMFVideoProcessor::GetVideoProcessorCaps pour rechercher les fonctionnalités de chaque mode de processeur vidéo.
  4. 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.
  5. Appelez IMFVideoProcessor::GetProcAmpRange et IMFVideoProcessor::GetFilteringRange pour rechercher la plage de valeurs pour les différents paramètres procAmp et filtre d’image.
  6. 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

Voir aussi

Convertisseur vidéo amélioré

Interfaces Media Foundation