Función MFStartup (mfapi.h)
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 |
---|---|
|
No inicialice la biblioteca de sockets. |
|
Equivalente a MFSTARTUP_NOSOCKET. |
|
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 |
---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
El parámetro Version requiere una versión más reciente de Media Foundation que la versión que se está ejecutando. |
|
La plataforma Media Foundation está deshabilitada porque el sistema se inició en "Modo seguro" (arranque con error). |
|
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 |