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