IMFSaveJob::BeginSave method (mfidl.h)

Begins saving a Windows Media file to the application's byte stream.

Syntax

HRESULT BeginSave(
  [in] IMFByteStream    *pStream,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

Parameters

[in] pStream

Pointer to the IMFByteStream interface of the application's byte stream. The data from the source byte stream is written to this byte stream.

[in] pCallback

Pointer to the IMFAsyncCallback interface of a callback object. The caller must implement this interface

[in] pState

Pointer to the IUnknown interface of a state object, defined by the caller. This parameter can be NULL. You can use this object to hold state information. The object is returned to the caller when the callback is invoked.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.

Remarks

When the operation completes, the callback object's IMFAsyncCallback::Invoke method is called. At that point, the application should call IMFSaveJob::EndSave to complete the asynchronous request.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFSaveJob