IMFVideoProcessor-Schnittstelle (evr9.h)
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.
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:
- 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.)
- Rufen Sie IMFVideoProcessor::GetAvailableVideoProcessorModes auf, um die Liste der verfügbaren Videoprozessormodi abzurufen.
- Rufen Sie IMFVideoProcessor::GetVideoProcessorCaps auf, um die Funktionen der einzelnen Videoprozessormodus zu ermitteln.
- 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.
- Rufen Sie IMFVideoProcessor::GetProcAmpRange und IMFVideoProcessor::GetFilteringRange auf, um den Wertebereich für die verschiedenen Einstellungen für ProcAmp- und Bildfilter zu ermitteln.
- 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 |