IMFCaptureSink-Schnittstelle (mfcaptureengine.h)

Steuert eine Erfassungssenke, bei der es sich um ein Objekt handelt, das einen oder mehrere Datenströme von einem Aufnahmegerät empfängt.

Vererbung

Die IMFCaptureSink-Schnittstelle erbt von der IUnknown-Schnittstelle . IMFCaptureSink verfügt auch über folgende Arten von Membern:

Methoden

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

IMFCaptureSink::AddStream Verbindet einen Stream aus der Erfassungsquelle mit dieser Erfassungssenke.
IMFCaptureSink::GetOutputMediaType Ruft das Ausgabeformat für einen Stream in dieser Erfassungssenke ab.
IMFCaptureSink::GetService Fragt das zugrunde liegende Sink Writer-Objekt nach einer Schnittstelle ab.
IMFCaptureSink::P repare Bereitet die Erfassungssenke vor, indem alle erforderlichen Pipelinekomponenten wie Encoder, Videoprozessoren und Mediensenken geladen werden.
IMFCaptureSink::RemoveAllStreams Entfernt alle Datenströme aus der Erfassungssenke.

Hinweise

Die Erfassungs-Engine erstellt die folgenden Erfassungssenken.

• Fotosenke. Codiert noch Bilddateien.
• Vorschausenke. Vorschau von Liveaudio oder -video.
• Aufzeichnungssenke. Erstellt komprimierte Audio-/Videodateien oder komprimierte Audio-/Videostreams.

Um einen Zeiger auf eine Erfassungssenke zu erhalten, rufen Sie IMFCaptureEngine::GetSink auf. Jede Erfassungssenke implementiert eine Schnittstelle, die von IMFCaptureSink abgeleitet ist. Rufen Sie QueryInterface auf, um einen Zeiger auf die abgeleitete Schnittstelle abzurufen.

Senke	Schnittstelle
Fotosenke	IMFCapturePhotoSink
Vorschausenke	IMFCapturePreviewSink
Aufzeichnungssenke	IMFCaptureRecordSink

 

Anwendungen können die Erfassungssenken nicht direkt erstellen.

Wenn ein nativer Medientyp für einen Bildstream auf JPEG festgelegt ist, sollte die Fotosenke mit einem Format konfiguriert werden, das mit dem nativen Quellformat identisch ist. Der native JPEG-Typ ist nur Passthrough.

Wenn ein nativer Bildstreamtyp auf JPEG festgelegt ist, ändern Sie zum Hinzufügen eines Effekts den nativen Typ für den Bildstream in einen nicht komprimierten Videomedientyp (z. B. NV12 oder RGB32), und fügen Sie dann den Effekt hinzu.

Wenn der systemeigene Typ H.264 für den Datensatzdatenstrom ist, sollte die Datensatzsenke mit demselben Medientyp konfiguriert werden. Der native H.264-Typ ist nur Passthrough und kann nicht decodiert werden.

Datensatzstreams, die H.264 verfügbar machen, machen keinen anderen Typ verfügbar. H.264-Datensatzdatenströme können nicht in Verbindung mit Effekten verwendet werden. Um Effekte hinzuzufügen, verbinden Sie stattdessen den Vorschaudatenstrom mithilfe von AddStream mit dem Recordsink.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfcaptureengine.h

Weitere Informationen

Media Foundation-Schnittstellen