IMFCaptureEngine::StartRecord-Methode (mfcaptureengine.h)

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