IMFVirtualCamera::Start-Methode (mfvirtualcamera.h)
Erstellt und registriert die virtuelle Kamera.
Syntax
HRESULT Start(
IMFAsyncCallback *pCallback
);
Parameter
pCallback
Optionaler Zeiger auf ein IMFAsyncCallback-Objekt , das die Pipeline verwendet, um den Aufrufer über den Zustand der virtuellen Kamera zu benachrichtigen. Der Rückruf kann, sofern angegeben, mit einem IMFMediaEvent aufgerufen werden. Wenn sie aufgerufen wird, gibt die IMFMediaEvent::GetType-Methode einen MEExtendedType oder einen MEError zurück. Wenn ein MEExtendedType zurückgegeben wird, gibt die IMFMediaEvent::GetExtendedType-Methode möglicherweise einen der folgenden Ereignistypen zurück:
| Erweiterter Ereignistyp | BESCHREIBUNG |
|---|---|
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_INITIALIZE | Die benutzerdefinierte Medienquelle, die die virtuelle Kamera darstellt, wurde von einer Anwendung initialisiert. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_START | Ein Stream (oder Streams) auf der benutzerdefinierten Medienquelle der virtuellen Kamera wurde von einer Anwendung gestartet. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_STOP | Alle Datenströme der benutzerdefinierten Medienquelle der virtuellen Kamera wurden von der Anwendung angehalten. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_UNINITIALIZE | Die benutzerdefinierte Medienquelle der virtuellen Kamera wurde nicht initialisiert. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_PIPELINE_SHUTDOWN | Die Pipeline der virtuellen Kamera wurde heruntergefahren. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_CUSTOM_EVENT | Ein benutzerdefiniertes Ereignis wurde von der benutzerdefinierten Medienquelle der virtuellen Kamera generiert. Das Schema für das IMFMediaEvent ist herstellerspezifisch. |
Der Rückruf kann jederzeit aufgerufen werden, nachdem die IMFVirtualCamera::Start erfolgreich zurückgegeben wurde.
Rückgabewert
Gibt einen HRESULT-Wert zurück, einschließlich, aber nicht beschränkt auf die folgenden Werte:
| Fehlercode | BESCHREIBUNG |
|---|---|
| S_OK | Erfolgreich |
| E_INVALIDARG | Ein Eingabeparameter ist ungültig. |
Hinweise
Bis ein erfolgreicher Aufruf der Start-Methode erfolgt ist, stellt die IMFVirtualCamera die Konfigurationsinformationen der virtuellen Kamera dar, und die zugrunde liegende virtuelle Kamera ist noch nicht vorhanden – es sei denn , die MFCreateVirtualCamera öffnet eine vorhandene virtuelle Kamera erneut. Nachdem Start erfolgreich aufgerufen wurde, enthalten die IMFAttributes , von denen IMFVirtualCamera erbt , den symbolischen Linknamen der neu erstellten virtuellen Kamera , MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK.
Wenn MFCreateVirtualCamera mit den gleichen Parametern wie ein vorheriger Aufruf aufgerufen wird, wobei eine IMFVirtualCamera angegeben wird, die bereits mit einem erfolgreichen Aufruf von IMFVirtualCamera::Start gestartet wurde, ist das Ergebnis IMFVirtualCamera bereits in einem gültigen Zustand, und nachfolgende Aufrufe von IMFVirtualCamera::Start können verwendet werden, um neue Rückrufe zu registrieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Build 22000 |
| Kopfzeile | mfvirtualcamera.h |
| Bibliothek | mfsensorgroup.lib |
| DLL | mfsensorgroup.dll |