Método IMFPMediaPlayer::CreateMediaItemFromURL (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 un elemento multimedia a partir de una dirección URL.

Sintaxis

HRESULT CreateMediaItemFromURL(
  [in]  LPCWSTR       pwszURL,
  [in]  BOOL          fSync,
  [in]  DWORD_PTR     dwUserData,
  [out] IMFPMediaItem **ppMediaItem
);

Parámetros

[in] pwszURL

Cadena terminada en NULL que contiene la dirección URL de un archivo multimedia.

[in] fSync

Si es TRUE, el método se bloquea hasta que se completa. Si es FALSE, el método no bloquea y se completa de forma asincrónica.

[in] dwUserData

Valor definido por la aplicación que se va a almacenar en el elemento multimedia. Para recuperar este valor del elemento multimedia, llame a IMFPMediaItem::GetUserData.

[out] ppMediaItem

Recibe un puntero a la interfaz IMFPMediaItem . El autor de la llamada debe liberar la interfaz . Si fSync es TRUE, este parámetro debe ser un puntero válido. Si bSync es FALSE, este parámetro debe ser NULL.

Valor devuelto

El método devuelve un valor 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.
E_INVALIDARG
 Argumento no válido.
MF_E_INVALIDREQUEST
 Solicitud no válida. Este error puede producirse cuando fSync es FALSE y la aplicación no proporcionó una interfaz de devolución de llamada. Vea la sección Comentarios.
MF_E_SHUTDOWN
 Se llamó al método Shutdown del objeto.
MF_E_UNSUPPORTED_SCHEME
 Protocolo no admitido.

Comentarios

Este método no pone en cola el elemento multimedia para la reproducción. Para poner en cola el elemento para su reproducción, llame a IMFPMediaPlayer::SetMediaItem.

El método CreateMediaItemFromURL se puede llamar de forma sincrónica o asincrónica:

  • Si fSync es TRUE, el método se completa de forma sincrónica. El puntero IMFPMediaItem se devuelve en el parámetro ppMediaItem .
  • Si fSync es FALSE, el método se completa de forma asincrónica. Cuando se completa la operación, se invoca el método de devolución de llamada IMFPMediaPlayerCallback::OnMediaPlayerEvent de la aplicación. El tipo de evento es MFP_EVENT_TYPE_MEDIAITEM_CREATED. Los datos del evento contienen el puntero IMFPMediaItem para el nuevo elemento multimedia.
La interfaz de devolución de llamada se establece cuando se llama por primera vez a MFPCreateMediaPlayer para crear el objeto de reproductor MFPlay. Si no proporciona una interfaz de devolución de llamada, el parámetro fSync debe ser TRUE. De lo contrario, CreateMediaItemFromURL devuelve MF_E_INVALIDREQUEST.

Si realiza varias llamadas asincrónicas a CreateMediaItemFromURL, no se garantiza que se completen en el mismo orden. Use el parámetro dwUserData para buscar coincidencias con elementos multimedia creados con solicitudes pendientes.

Actualmente, este método devuelve MF_E_UNSUPPORTED_SCHEME si la dirección URL especifica cualquiera de los protocolos siguientes: rtsp*, mms*o mcast. Si desea usar el origen de red de Media Foundation con MFPlay, use primero el Solucionador de origen para crear el origen y, a continuación, llame a IMFPMediaPlayer::CreateMediaItemFromObject.

Configuración del origen

Internamente, este método crea un origen multimedia. Para configurar el origen multimedia, haga lo siguiente:
  1. Llame a QueryInterface en el puntero IMFPMediaPlayer para obtener la interfaz IPropertyStore .
  2. Llame a IPropertyStore::SetValue para establecer propiedades para el origen multimedia. Para obtener una lista de las propiedades de configuración, consulte Configuración de un origen multimedia. Los orígenes de medios de terceros pueden definir propiedades personalizadas.
  3. Llame al método CreateMediaItemFromURL para crear el elemento multimedia.

Requisitos

   
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

Consulte también

IMFPMediaPlayer

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