IMFFinalizableMediaSink::BeginFinalize 方法 (mfidl.h)

通知媒体接收器异步执行完成其任务所需的任何步骤。

语法

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

parameters

[in] pCallback

指向异步对象的 IMFAsyncCallback 接口的指针。 调用方必须实现此接口。

[in] punkState

指向由调用方定义的状态对象的 IUnknown 接口的指针。 此参数可以为 NULL。 可以使用此对象来保存状态信息。 调用回调时,对象将返回到调用方。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。

注解

许多存档媒体接收器都有在存档结束时需要执行的步骤来完成其文件操作,例如更新某些格式的标头 () 或刷新所有挂起的写入到磁盘。 在某些情况下,这可能包括成本高昂的操作,例如为内容编制索引。 BeginFinalize 是启动最终任务的异步方法。

完成完成操作后,将调用回调对象的 IMFAsyncCallback::Invoke 方法。 此时,应用程序应调用 IMFFinalizableMediaSink::EndFinalize 以完成异步请求。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 mfidl.h
Library Mfuuid.lib

另请参阅

IMFFinalizableMediaSink