IMFCaptureEngine::StartPreview-Methode (mfcaptureengine.h)

  • Artikel

Startet die Vorschau.

Syntax

HRESULT StartPreview();

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
MF_E_INVALIDREQUEST
 Die Vorschausenke wurde nicht initialisiert.

Hinweise

Konfigurieren Sie vor dem Aufrufen dieser Methode die Vorschausenke, indem Sie IMFCaptureSink::AddStream aufrufen. Um einen Zeiger auf die Vorschausenke zu erhalten, rufen Sie IMFCaptureEngine::GetSink auf.

Diese Methode ist asynchron. Wenn die Methode einen Erfolgscode zurückgibt, empfängt der Aufrufer über die IMFCaptureEngineOnEventCallback::OnEvent-Methode ein MF_CAPTURE_ENGINE_PREVIEW_STARTED-Ereignis. Der Vorgang kann asynchron fehlschlagen, nachdem die Methode erfolgreich war. Wenn ja, wird der Fehlercode über die OnEvent-Methode übermittelt.

Nachdem die Vorschausenke konfiguriert wurde, können Sie die Vorschau beenden und starten, indem Sie IMFCaptureEngine::StopPreview und IMFCaptureEngine::StartPreview aufrufen.

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

IMFCaptureEngine