IQualityControl-Schnittstelle (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die IQualityControl -Schnittstelle bietet Unterstützung für die Qualitätskontrolle. Ein Objekt macht diese Schnittstelle verfügbar, wenn es Qualitätskontrollmeldungen generieren oder empfangen kann. Dies umfasst Rendererfilter (die in der Regel Qualitätskontrollmeldungen generieren), Pins (die diese empfangen) und externe Qualitätsmanager (die sie ebenfalls empfangen).

Ein Rendererfilter generiert eine Qualitätskontrollmeldung, indem die IQualityControl::Notify-Methode am Ausgabepin des Upstream Filters aufgerufen wird. Der Upstream Filter verarbeitet die Nachricht oder übergibt sie Upstream.

Eine Anwendung kann einen eigenen Qualitätskontroll-Manager implementieren. Rufen Sie IQualityControl::SetSink auf dem Renderer auf, um den Qualitätskontroll-Manager als Empfänger für Qualitätskontrollnachrichten festzulegen. Durch Aufrufen dieser Methode wird die Standardbehandlung von Qualitätskontrollmeldungen außer Kraft gesetzt.

Die meisten Anwendungen werden jedoch keine eigenen Qualitätskontrollmanager implementieren; Abgesehen von diesem Sonderfall verwenden Anwendungen diese Schnittstelle in der Regel nicht. Weitere Informationen finden Sie unter Qualitätskontrollmanagement.

Vererbung

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

Methoden

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

IQualityControl::Notify Die Notify-Methode benachrichtigt den Filter, dass eine Qualitätsänderung angefordert wird.
IQualityControl::SetSink Die SetSink-Methode legt das IQualityControl-Objekt fest, das Qualitätsmeldungen empfängt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)