Metodo IMFFinalizableMediaSink::BeginFinalize (mfidl.h)

Notifica al sink multimediale di eseguire in modo asincrono i passaggi necessari per completare le attività.

Sintassi

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

Parametri

[in] pCallback

Puntatore all'interfaccia IMFAsyncCallback di un oggetto asincrono. Il chiamante deve implementare questa interfaccia.

[in] punkState

Puntatore all'interfaccia IUnknown di un oggetto di stato, definito dal chiamante. Questo parametro può essere NULL. È possibile utilizzare questo oggetto per contenere le informazioni sullo stato. L'oggetto viene restituito al chiamante quando viene richiamato il callback.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Molti sink multimediali di archiviazione hanno passaggi da eseguire alla fine dell'archiviazione per completare le operazioni sui file, ad esempio l'aggiornamento dell'intestazione (per alcuni formati) o lo scaricamento di tutte le scritture in sospeso su disco. In alcuni casi, ciò può includere operazioni costose, ad esempio l'indicizzazione del contenuto. BeginFinalize è un modo asincrono per avviare le attività finali.

Al termine dell'operazione di finalizzazione, viene chiamato il metodo IMFAsyncCallback::Invoke dell'oggetto callback. A questo punto, l'applicazione deve chiamare IMFFinalizableMediaSink::EndFinalize per completare la richiesta asincrona.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mfuuid.lib

Vedi anche

IMFFinalizableMediaSink