Método IMFPMediaPlayer::CreateMediaItemFromURL (mfplay.h)
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 |
---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
Argumento no válido. |
|
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. |
|
Se llamó al método Shutdown del objeto. |
|
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.
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:- Llame a QueryInterface en el puntero IMFPMediaPlayer para obtener la interfaz IPropertyStore .
- 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.
- 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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de