IMFCaptureEngine::StartRecord-Methode (mfcaptureengine.h)

  • Artikel

Startet die Aufzeichnung von Audio und/oder Video in einer Datei.

Syntax

HRESULT StartRecord();

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

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

Hinweise

Konfigurieren Sie vor dem Aufrufen dieser Methode die Aufzeichnungssenke, indem Sie IMFCaptureSink::AddStream aufrufen. Um einen Zeiger auf die Aufzeichnungssenke 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_RECORD_STARTED-Ereignis. Der Vorgang kann asynchron fehlschlagen, nachdem die Methode erfolgreich war. Wenn ja, wird der Fehlercode über die OnEvent-Methode übermittelt.

Um die Aufzeichnung zu beenden, rufen Sie IMFCaptureEngine::StopRecord auf.

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