Función MFPCreateMediaPlayer (mfplay.h)

  • Artículo
Importante Obsoleto. Esta API se puede quitar de futuras versiones de Windows. Las aplicaciones deben usar la sesión multimedia para la reproducción.
 

Crea una nueva instancia del objeto de reproductor MFPlay.

Sintaxis

HRESULT MFPCreateMediaPlayer(
  [in]  LPCWSTR                 pwszURL,
  [in]  BOOL                    fStartPlayback,
  [in]  MFP_CREATION_OPTIONS    creationOptions,
  [in]  IMFPMediaPlayerCallback *pCallback,
  [in]  HWND                    hWnd,
  [out] IMFPMediaPlayer         **ppMediaPlayer
);

Parámetros

[in] pwszURL

Cadena terminada en NULL que contiene la dirección URL de un archivo multimedia que se va a abrir. Este parámetro puede ser NULL. Si el parámetro es NULL, fStartPlayback debe ser FALSE.

Si este parámetro es NULL, puede abrir una dirección URL más adelante llamando a IMFPMediaPlayer::CreateMediaItemFromURL.

[in] fStartPlayback

Si es TRUE, la reproducción se inicia automáticamente. Si es FALSE, la reproducción no se inicia hasta que la aplicación llama a IMFMediaPlayer::P lay.

Si pwszURL es NULL, se omite este parámetro.

[in] creationOptions

OR bit a bit de cero de más marcas de la enumeración _MFP_CREATION_OPTIONS.

[in] pCallback

Puntero a la interfaz IMFPMediaPlayerCallback de un objeto de devolución de llamada, implementado por la aplicación. Utilice esta interfaz para obtener notificaciones de eventos del objeto de reproductor MFPlay. Este parámetro puede ser NULL. Si el parámetro es NULL, la aplicación no recibirá notificaciones de eventos del objeto player.

[in] hWnd

Identificador de una ventana en la que aparecerá el vídeo. Para la reproducción de solo audio, este parámetro puede ser NULL.

La ventana especificada por hWnd se usa para la primera secuencia de vídeo seleccionada en el origen. Si el origen tiene varias secuencias de vídeo, debe llamar a IMFPMediaItem::SetStreamSink para representar cualquiera de las secuencias de vídeo después de la primera.

Si hWnd es NULL, MFPlay no mostrará ningún vídeo a menos que la aplicación llame a IMFPMediaItem::SetStreamSink para especificar un receptor multimedia para la secuencia de vídeo.

[out] ppMediaPlayer

Recibe un puntero a la interfaz IMFPMediaPlayer . El autor de la llamada debe liberar la interfaz . Este parámetro puede ser NULL. Si este parámetro es NULL, fStartPlayback debe ser TRUE y pwszURL no puede ser NULL.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Antes de llamar a esta función, llame a CoIntialize(Ex) desde el mismo subproceso para inicializar la biblioteca COM.

Internamente, MFPCreateMediaPlayer llama a MFStartup para inicializar la plataforma microsoft Media Foundation. Cuando se destruye el objeto player, llama a MFShutdown para apagar la plataforma. No es necesario que una aplicación llame a MFStartup o MFShutdown al usar MFPlay.

Nota Si usa otras API de Media Foundation fuera del tiempo de vida del objeto player, la aplicación debe llamar a MFStartup y MFShutdown.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfplay.h
Library Mfplay.lib
Archivo DLL Mfplay.dll

Consulte también

Funciones de Media Foundation

Uso de MFPlay para la reproducción de audio y vídeo