Метод 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
Header	mfidl.h
Библиотека	Mfuuid.lib

См. также раздел

IMFFinalizableMediaSink