Método IMFPMediaPlayer::SetMediaItem (mfplay.h)

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

 

Pone en cola un elemento multimedia para la reproducción.

Sintaxis

HRESULT SetMediaItem(
  [in] IMFPMediaItem *pIMFPMediaItem
);

Parámetros

[in] pIMFPMediaItem

Puntero a la interfaz IMFPMediaItem del elemento multimedia.

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_DRM_UNSUPPORTED	El elemento multimedia contiene contenido protegido. MFPlay actualmente no admite contenido protegido.
MF_E_NO_AUDIO_PLAYBACK_DEVICE	No se encontró ningún dispositivo de reproducción de audio. Este error puede producirse si el origen multimedia contiene audio, pero no hay dispositivos de reproducción de audio disponibles en el sistema.
MF_E_SHUTDOWN	Se llamó al método Shutdown del objeto.

Comentarios

Este 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_SET.

Para crear un elemento multimedia, llame a IMFPMediaPlayer::CreateMediaItemFromObject o IMFPMediaPlayer::CreateMediaItemFromURL. Se debe usar un elemento multimedia con el mismo objeto de reproductor MFPlay que creó ese elemento. Si el elemento multimedia se creó mediante una instancia diferente del objeto player, SetMediaItem devuelve E_INVALIDARG.

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

Consulte también

IMFPMediaPlayer

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