Función MFStartup (mfapi.h)

  • Artículo

Inicializa Microsoft Media Foundation.

Sintaxis

HRESULT MFStartup(
  ULONG Version,
  DWORD dwFlags
);

Parámetros

Version

Número de versión. Use el valor MF_VERSION, definido en mfapi.h.

dwFlags

Este parámetro es opcional cuando se usa C++ pero es necesario en C. El valor debe ser una de las siguientes marcas:

Valor Significado
MFSTARTUP_NOSOCKET
 No inicialice la biblioteca de sockets.
MFSTARTUP_LITE
 Equivalente a MFSTARTUP_NOSOCKET.
MFSTARTUP_FULL
 Inicialice toda la plataforma de Media Foundation. Este es el valor predeterminado cuando no se especifica dwFlags .

Valor devuelto

La función devuelve un HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_BAD_STARTUP_VERSION
 El parámetro Version requiere una versión más reciente de Media Foundation que la versión que se está ejecutando.
MF_E_DISABLED_IN_SAFEMODE
 La plataforma Media Foundation está deshabilitada porque el sistema se inició en "Modo seguro" (arranque con error).
E_NOTIMPL
 Media Foundation no se implementa en el sistema. Este error puede producirse si los componentes multimedia no están presentes (consulte KB2703761 para obtener más información).

Comentarios

Una aplicación debe llamar a esta función antes de usar Media Foundation. Antes de que la aplicación salga, llame a MFShutdown una vez para cada llamada anterior a MFStartup.

Se debe llamar a MFStartup durante la llamada durante la inicialización de la aplicación y no desde constructores estáticos durante la inicialización del proceso.

No llame a MFStartup o MFShutdown desde subprocesos de cola de trabajo. Para obtener más información sobre las colas de trabajo, consulte Colas de trabajo.

Esta función está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalado.

Ejemplos

    hr = MFStartup(MF_VERSION);

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfapi.h
Library Mfplat.lib
Archivo DLL Mfplat.dll

Consulte también

Inicialización de Media Foundation

Funciones de Media Foundation