Skip to main content
IMFCaptureEngine::StartRecord method

Starts recording audio and/or video to a file.

Syntax


HRESULT StartRecord();

Parameters

This method has no parameters.

Return value

This method can return one of these values.

Return codeDescription
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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Mfcaptureengine.h

See also

IMFCaptureEngine