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.
| 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 |