IMFVirtualCamera::GetMediaSource-Methode (mfvirtualcamera.h)
Ruft eine IMFMediaSource ab, die Mediendaten von der virtuellen Kamera bereitstellt.
Syntax
HRESULT GetMediaSource(
IMFMediaSource **ppMediaSource
);
Parameter
ppMediaSource
Eine SHARED-Client-IMFMediaSource von der virtuellen Kamera.
Rückgabewert
| Fehlercode | BESCHREIBUNG |
|---|---|
| S_OK | Erfolgreich |
Hinweise
GetMediaSource kann erst aufgerufen werden, nachdem IMFVirtualCamera::Start erfolgreich aufgerufen wurde. Die im parameter ppMediaSource zurückgegebene IMFMediaSource ist eine Medienquelle mit eingeschränkter Funktionalität. Es ist intern als freigegebener Client gekennzeichnet. Diese Medienquelle ist für Apps vorgesehen, die während der Aktivierung und Konfiguration virtueller Kameras als lokale Vorschau verwendet werden können.
Wenn eine vollständige Funktion IMFMediaSource benötigt wird, muss die App MFCreateDeviceSource mithilfe des symbolischen Linknamens aufrufen, der in den IMFAttributes nach einem IMFVirtualCamera::Start-Aufruf zurückgegeben wird. Dies führt jedoch dazu, dass eine Medienquelle mit exklusiver Steuerung erstellt wird, die bei Aktivierung alle anderen Apps von der Verwendung der virtuellen Kamera ausschließt.
Die Lebensdauer der von dieser Methode abgerufenen IMFMediaSource ist direkt an die Lebensdauer der IMFVirtualCamera gebunden, aus der sie abgerufen wird. Wenn die IMFVirtualCamera verworfen oder IMFVirtualCamera::Shutdown aufgerufen wird, wird auch die von dieser Methode abgerufene IMFMediaSource heruntergefahren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Build 22000 |
| Kopfzeile | mfvirtualcamera.h |
| Bibliothek | mfsensorgroup.lib |
| DLL | mfsensorgroup.dll |