Поделиться через

Функция MFLockPlatform (mfapi.h)

  • Статья

Блокирует функцию MFShutdown .

Синтаксис

HRESULT MFLockPlatform();

Возвращаемое значение

Функция возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Функция выполнена успешно.

Комментарии

Эта функция предотвращает завершение работы потоков рабочих очередей при вызове MFShutdown . Используйте эту функцию, чтобы обеспечить корректное выполнение асинхронных операций до завершения работы платформы.

Эта функция удерживает блокировку на платформе Media Foundation. Чтобы разблокировать платформу, вызовите MFUnlockPlatform. Приложение должно вызывать MFUnlockPlatform один раз для каждого вызова MFLockPlatform.

Функция MFShutdown блокируется до тех пор, пока платформа не будет разблокирована или не истечет фиксированный период ожидания. (Период ожидания составляет несколько секунд.) Чтобы избежать утечки памяти, приложение должно разблокировать платформу до окончания периода ожидания. Например, отмените все асинхронные операции, которые ожидают завершения и удерживают блокировку на платформе.

Реализация интерфейса IMFAsyncResult по умолчанию автоматически блокирует платформу Media Foundation при создании результирующих объектов. Освобождение интерфейса разблокирует платформу. Поэтому в большинстве случаев приложению не требуется напрямую блокировать платформу. Дополнительные сведения см. в разделе Рабочие очереди.

Эта функция доступна на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media Format 11:

  • Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
  • Windows XP Media Center Edition 2005 с установленными kb900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления для Windows XP Media Center Edition за октябрь 2006 г.).

Требования

   
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfapi.h
Библиотека Mfplat.lib
DLL Mfplat.dll

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

Функции Media Foundation

API платформы Media Foundation

Рабочие очереди