IMFCaptureEngine::StartRecord method (mfcaptureengine.h)

Starts recording audio and/or video to a file.

Syntax

HRESULT StartRecord();

Return value

This method can return one of these values.

Return code	Description
S_OK	Success.
MF_E_INVALIDREQUEST	The recording sink was not initialized.

Remarks

Before calling this method, configure the recording sink by calling IMFCaptureSink::AddStream. To get a pointer to the recording sink, call IMFCaptureEngine::GetSink.

This method is asynchronous. If the method returns a success code, the caller will receive an MF_CAPTURE_ENGINE_RECORD_STARTED event through the IMFCaptureEngineOnEventCallback::OnEvent method. The operation can fail asynchronously after the method succeeds. If so, the error code is conveyed through the OnEvent method.

To stop recording, call IMFCaptureEngine::StopRecord.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Target Platform	Windows
Header	mfcaptureengine.h

See also

IMFCaptureEngine