IQualityControl::SetSink-Methode (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 SetSink -Methode legt das IQualityControl-Objekt fest, das Qualitätsmeldungen empfängt.

Syntax

HRESULT SetSink(
  IQualityControl *piqc
);

Parameter

piqc

Zeiger auf das IQualityControl-Objekt , an das die Benachrichtigungen gesendet werden sollen.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der von der Implementierung abhängt. HRESULT kann eine der folgenden Standardkonstanten oder andere Werte sein, die nicht aufgeführt sind.

Rückgabecode	Beschreibung
E_FAIL	Fehler.
E_POINTER	NULL-Zeigerargument.
E_INVALIDARG	Ungültiges Argument.
E_NOTIMPL	Die -Methode wird nicht unterstützt.
S_OK oder NOERROR	Erfolg.

Hinweise

Der Filter, der einen Aufruf dieser Methode empfängt, sollte die piqc aufzeichnen, aber keine Verweisanzahl hinzufügen. Das Objekt, auf das verwiesen wird, ist ein Qualitätsmanager und Teil des Filterdiagramms (z. B. ein Plug-In-Verteiler). Das Hinzufügen einer Verweisanzahl kann zu Zirkelverweisproblemen führen.

Der Verweis auf das in piqc angegebene Objekt ist garantiert gültig, bis diese Methode mit einem NULL-Wert aufgerufen wird.

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)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IQualityControl-Schnittstelle