共用方式為


IMFFinalizableMediaSink::BeginFinalize 方法 (mfidl.h)

通知媒體接收以非同步方式採取完成其工作所需的任何步驟。

語法

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

參數

[in] pCallback

非同步物件的 IMFAsyncCallback 介面指標。 呼叫端必須實作這個介面。

[in] punkState

狀態物件的 IUnknown 介面指標,由呼叫端定義。 此參數可以是 Null。 您可以使用這個物件來保存狀態資訊。 叫用回呼時,物件會傳回給呼叫端。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。

備註

許多封存媒體接收都有在封存結束時必須執行的步驟,以完成其檔案作業,例如更新某些格式的標頭 () ,或排清磁片上所有擱置的寫入。 在某些情況下,這可能包括昂貴的作業,例如編制內容的索引。 BeginFinalize 是起始最終工作的非同步方式。

完成作業完成時,會呼叫回呼物件的 IMFAsyncCallback::Invoke 方法。 此時,應用程式應該呼叫 IMFFinalizableMediaSink::EndFinalize 來完成非同步要求。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mfuuid.lib

另請參閱

IMFFinalizableMediaSink