IMFVideoProcessor-Schnittstelle (evr9.h)

  • Artikel

Steuert die Videoverarbeitung im erweiterten Video renderer (EVR ). Die über diese Schnittstelle gesteuerten Vorgänge umfassen Farbanpassung (ProcAmp), Rauschfilter und Detailfilter.

Der EVR-Mixer implementiert diese Schnittstelle. Um einen Zeiger auf die Schnittstelle zu erhalten, rufen Sie IMFGetService::GetService auf. Der Dienstbezeichner ist GUID MR_VIDEO_MIXER_SERVICE. Rufen Sie GetService für eines der folgenden Objekte auf:

  • Die Mediensitzung (wenn die Topologie eine instance der EVR enthält).
  • Die EVR-Mediensenke.
  • Der DirectShow EVR-Filter.
  • Der EVR-Mixer.
Wenn Sie einen benutzerdefinierten Mixer für den EVR implementieren, kann der Mixer diese Schnittstelle optional als Dienst verfügbar machen.

Vererbung

Die IMFVideoProcessor-Schnittstelle erbt von der IUnknown-Schnittstelle . IMFVideoProcessor verfügt auch über folgende Membertypen:

Methoden

Die IMFVideoProcessor-Schnittstelle verfügt über diese Methoden.

 
IMFVideoProcessor::GetAvailableVideoProcessorModes

Ruft die Videoprozessormodi ab, die der Videotreiber unterstützt.
IMFVideoProcessor::GetBackgroundColor

Ruft die Hintergrundfarbe für das Kompositionsrechteck ab. Die Hintergrundfarbe wird für den Briefkasten des Videobilds verwendet.
IMFVideoProcessor::GetFilteringRange

Ruft den Wertebereich für eine angegebene Bildfiltereinstellung ab.
IMFVideoProcessor::GetFilteringValue

Ruft die aktuelle Einstellung für einen Bildfilter ab.
IMFVideoProcessor::GetProcAmpRange

Ruft den Wertebereich für eine Farbanpassungseinstellung (ProcAmp) ab.
IMFVideoProcessor::GetProcAmpValues

Ruft die aktuellen Einstellungen für mindestens eine Farbanpassung (ProcAmp) ab.
IMFVideoProcessor::GetVideoProcessorCaps

Ruft die Funktionen eines Videoprozessormodus ab.
IMFVideoProcessor::GetVideoProcessorMode

Ruft den bevorzugten Videoprozessormodus der Anwendung ab. Um den bevorzugten Modus festzulegen, rufen Sie IMFVideoProcessor::SetVideoProcessorMode auf.
IMFVideoProcessor::SetBackgroundColor

Legt die Hintergrundfarbe für das Kompositionsrechteck fest. Die Hintergrundfarbe wird für den Briefkasten des Videobilds verwendet.
IMFVideoProcessor::SetFilteringValue

Legt einen Parameter für einen Bildfilter fest.
IMFVideoProcessor::SetProcAmpValues

Legt mindestens eine Farbanpassung (ProcAmp) fest.
IMFVideoProcessor::SetVideoProcessorMode

Legt den bevorzugten Videoprozessormodus fest. Der EVR versucht, diesen Modus zu verwenden, wenn die Wiedergabe gestartet wird.

Hinweise

Diese Schnittstelle bietet Zugriff auf Funktionen, die vom Grafiktreiber implementiert werden. Der Treiber stellt einen oder mehrere Videoprozessormodi bereit, die durch GUID identifiziert werden. Jeder Modus verfügt über einen eigenen Satz von Funktionen. Die Liste der verfügbaren Modi kann sich je nach Medientyp des Videos ändern.

Führen Sie die folgenden Schritte aus, um diese Schnittstelle zu verwenden:

  1. Initialisieren Sie die Medientypen in den EVR-Eingabestreams. (Wenn Sie die Mediensitzung verwenden, tritt dies auf, nachdem die Topologie aufgelöst wurde. Warten Sie, bis die Mediensitzung das EREIGNIS MESessionTopologyStatus mit dem status Wert MF_TOPOSTATUS_READY sendet.)
  2. Rufen Sie IMFVideoProcessor::GetAvailableVideoProcessorModes auf, um die Liste der verfügbaren Videoprozessormodi abzurufen.
  3. Rufen Sie IMFVideoProcessor::GetVideoProcessorCaps auf, um die Funktionen der einzelnen Videoprozessormodus zu ermitteln.
  4. Rufen Sie IMFVideoProcessor::SetVideoProcessorMode auf, um einen Modus auszuwählen. Wenn Sie diesen Schritt überspringen, wählt der EVR automatisch einen Videoprozessormodus aus, wenn das Streaming beginnt. Warten Sie in diesem Fall, bis die Wiedergabe gestartet wird, bevor Sie mit Schritt 5 fortfahren.
  5. Rufen Sie IMFVideoProcessor::GetProcAmpRange und IMFVideoProcessor::GetFilteringRange auf, um den Wertebereich für die verschiedenen Einstellungen für ProcAmp- und Bildfilter zu ermitteln.
  6. Rufen Sie IMFVideoProcessor::SetProcAmpValues und IMFVideoProcessor::SetFilteringValue auf, um die Einstellungen für ProcAmp- und Bildfilter zu ändern.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile evr9.h

Weitere Informationen

Erweiterter Videorenderer

Media Foundation-Schnittstellen