Export (0) Print
Expand All

IMFFinalizableMediaSink::BeginFinalize method

Notifies the media sink to asynchronously take any steps it needs to finish its tasks.

Syntax


HRESULT BeginFinalize(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parameters

pCallback [in]

Pointer to the IMFAsyncCallback interface of an asynchronous object. The caller must implement this interface.

punkState [in]

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

The method succeeded.

 

Remarks

Many archive media sinks have steps they need to do at the end of archiving to complete their file operations, such as updating the header (for some formats) or flushing all pending writes to disk. In some cases, this may include expensive operations such as indexing the content. BeginFinalize is an asynchronous way to initiate final tasks.

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

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mfidl.h

Library

Mfuuid.lib

See also

IMFFinalizableMediaSink

 

 

Community Additions

ADD
Show:
© 2015 Microsoft