Método IMFMediaEngineClassFactory::CreateInstance (mfmediaengine.h)

  • Artículo

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
S_OK
 Correcto.
MF_E_ATTRIBUTENOTFOUND
 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:
MF_MEDIA_ENGINE_PLAYBACK_HWND
MF_MEDIA_ENGINE_PLAYBACK_VISUAL
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:
MF_MEDIA_ENGINE_OPM_HWND
MF_MEDIA_ENGINE_CONTENT_PROTECTION_FLAGS
MF_MEDIA_ENGINE_CONTENT_PROTECTION_MANAGER
Opcional. Opcional. Opcional.
Reproducción de audio Cualquiera de los siguientes:
MF_MEDIA_ENGINE_AUDIO_CATEGORY
MF_MEDIA_ENGINE_AUDIO_ENDPOINT_ROLE
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

Consulte también

IMFMediaEngineClassFactory