Share via

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

  • Artigo
Importante Preterido. Essa API pode ser removida de versões futuras do Windows. Os aplicativos devem usar a Sessão de Mídia para reprodução.
 

Enfileira um item de mídia para reprodução.

Sintaxe

HRESULT SetMediaItem(
  [in] IMFPMediaItem *pIMFPMediaItem
);

Parâmetros

[in] pIMFPMediaItem

Ponteiro para a interface IMFPMediaItem do item de mídia.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 Argumento inválido.
MF_E_DRM_UNSUPPORTED
 O item de mídia contém conteúdo protegido. Atualmente, o MFPlay não dá suporte a conteúdo protegido.
MF_E_NO_AUDIO_PLAYBACK_DEVICE
 Nenhum dispositivo de reprodução de áudio foi encontrado. Esse erro poderá ocorrer se a fonte de mídia contiver áudio, mas nenhum dispositivo de reprodução de áudio estiver disponível no sistema.
MF_E_SHUTDOWN
 O método Shutdown do objeto foi chamado.

Comentários

Esse método é concluído de forma assíncrona. Quando a operação for concluída, o método de retorno de chamada IMFPMediaPlayerCallback::OnMediaPlayerEvent do aplicativo será invocado. O tipo de evento é MFP_EVENT_TYPE_MEDIAITEM_SET.

Para criar um item de mídia, chame IMFPMediaPlayer::CreateMediaItemFromObject ou IMFPMediaPlayer::CreateMediaItemFromURL. Um item de mídia deve ser usado com o mesmo objeto de player MFPlay que criou esse item. Se o item de mídia tiver sido criado por uma instância diferente do objeto player, SetMediaItem retornará E_INVALIDARG.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfplay.h

Confira também

IMFPMediaPlayer

Usando mfplay para reprodução de áudio/vídeo