Método IMFMediaEngineClassFactory::CreateInstance (mfmediaengine.h)
Crea una nueva instancia del motor de medios.
Sintaxis
HRESULT CreateInstance(
[in] DWORD dwFlags,
[in] IMFAttributes *pAttr,
[out] IMFMediaEngine **ppPlayer
);
Parámetros
[in] dwFlags
Or bit a bit de cero o más marcas de la enumeración MF_MEDIA_ENGINE_CREATEFLAGS .
[in] pAttr
Puntero a la interfaz IMFAttributes de un almacén de atributos.
Este parámetro especifica los atributos de configuración del motor multimedia. Llame a MFCreateAttributes para crear el almacén de atributos. A continuación, establezca uno o varios atributos de la lista de atributos del motor multimedia. Para conocer más detalles, vea la sección Comentarios.
[out] ppPlayer
Recibe un puntero a la interfaz IMFMediaEngine . El autor de la llamada debe liberar la interfaz .
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
Faltaba un atributo requerido en pAttr o se usó una combinación no válida de atributos. |
Comentarios
Antes de llamar a este método, llame a MFStartup.
El motor multimedia admite tres modos distintos:
| Mode | Descripción |
|---|---|
| Modo de servidor de fotogramas |
En este modo, el motor multimedia entrega fotogramas de vídeo sin comprimir a la aplicación. La aplicación es responsable de mostrar cada fotograma, mediante Microsoft Direct3D o cualquier otra técnica de representación.
El motor multimedia representa el audio; la aplicación no es responsable de la representación de audio. El modo de servidor de fotogramas es el modo predeterminado. |
| Modo de representación |
En este modo, el motor multimedia representa tanto audio como vídeo. El vídeo se representa en una ventana o en un objeto visual Microsoft DirectComposition proporcionado por la aplicación.
Para habilitar el modo de representación, establezca el atributo MF_MEDIA_ENGINE_PLAYBACK_HWND o el atributo MF_MEDIA_ENGINE_PLAYBACK_VISUAL . |
| Modo de audio |
En este modo, el motor multimedia solo representa audio, sin vídeo.
Para habilitar el modo de audio, establezca la marca MF_MEDIA_ENGINE_AUDIOONLY en el parámetro dwFlags . |
Atributos de inicialización
Los atributos siguientes se definen para el parámetro pAttr . Algunos son obligatorios y otros son opcionales, según el modo que desee.| Característica | Atributos | Modo de servidor marco | Modo de representación | Modo de audio |
|---|---|---|---|---|
| Devolución de llamada de eventos | MF_MEDIA_ENGINE_CALLBACK | Necesario. | Necesario. | Necesario. |
| Destino de representación | Uno de los siguientes: Estos atributos son mutuamente excluyentes. Si se establece cualquiera de estos atributos, el motor multimedia se pone en modo de representación. | No lo establezca. | Necesario. | No lo establezca. |
| Formato Direct3D | MF_MEDIA_ENGINE_VIDEO_OUTPUT_FORMAT | Necesario. | Opcional. | No lo establezca. |
| Administrador de dispositivos de microsoft DirectX Graphics Infrastructure (DXGI) | MF_MEDIA_ENGINE_DXGI_MANAGER | Opcional. | Opcional. | No lo establezca. |
| Extensiones del motor multimedia | MF_MEDIA_ENGINE_EXTENSION | Opcional. | Opcional. | Opcional. |
| Protección de contenido | Cualquiera de los siguientes: | Opcional. | Opcional. | Opcional. |
| Reproducción de audio | Cualquiera de los siguientes: | Opcional. | Opcional. | Opcional. |
Windows Phone 8
Se admite esta API.En el teléfono, el motor multimedia solo admite el modo de servidor de fotogramas. Se producirá un error al intentar inicializar la interfaz en modo de representación o en modo de audio.
Requisitos
| Cliente mínimo compatible | Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | mfmediaengine.h |