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