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

  • Статья

Инициализирует Microsoft Media Foundation.

Синтаксис

HRESULT MFStartup(
  ULONG Version,
  DWORD dwFlags
);

Параметры

Version

Номер версии. Используйте значение MF_VERSION, определенное в mfapi.h.

dwFlags

Этот параметр необязателен при использовании C++, но является обязательным в C. Значение должно иметь один из следующих флагов:

Значение Значение
MFSTARTUP_NOSOCKET
 Не инициализировать библиотеку сокетов.
MFSTARTUP_LITE
 Эквивалент MFSTARTUP_NOSOCKET.
MFSTARTUP_FULL
 Инициализируйте всю платформу Media Foundation. Это значение по умолчанию, если параметр dwFlags не указан.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_BAD_STARTUP_VERSION
 Для параметра Version требуется более новая версия Media Foundation, чем запущенная версия.
MF_E_DISABLED_IN_SAFEMODE
 Платформа Media Foundation отключена, так как система запущена в безопасном режиме (безопасная загрузка).
E_NOTIMPL
 Media Foundation не реализован в системе. Эта ошибка может возникнуть, если компоненты мультимедиа отсутствуют (дополнительные сведения см . в KB2703761 ).

Комментарии

Приложение должно вызвать эту функцию перед использованием Media Foundation. Перед выходом приложения вызывайте MFShutdown один раз для каждого предыдущего вызова MFStartup.

MFStartup должен вызываться во время инициализации приложения, а не из статических конструкторов во время инициализации процесса.

Не вызывайте MFStartup или MFShutdown из потоков рабочей очереди. Дополнительные сведения о рабочих очередях см. в разделе Рабочие очереди.

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

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

Примеры

    hr = MFStartup(MF_VERSION);

Требования

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

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

Инициализация Media Foundation

Функции Media Foundation