Função MFPCreateMediaPlayer (mfplay.h)

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.

 

Cria uma nova instância do objeto de player MFPlay.

Sintaxe

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

Cadeia de caracteres terminada em nulo que contém a URL de um arquivo de mídia a ser aberto. Este parâmetro pode ser NULL. Se o parâmetro for NULL, fStartPlayback deverá ser FALSE.

Se esse parâmetro for NULL, você poderá abrir uma URL mais tarde chamando IMFPMediaPlayer::CreateMediaItemFromURL.

[in] fStartPlayback

Se TRUE, a reprodução será iniciada automaticamente. Se FALSE, a reprodução não será iniciada até que o aplicativo chame IMFMediaPlayer::P lay.

Se pwszURL for NULL, esse parâmetro será ignorado.

[in] creationOptions

OR bit a bit de zero de mais sinalizadores da enumeração _MFP_CREATION_OPTIONS.

[in] pCallback

Ponteiro para a interface IMFPMediaPlayerCallback de um objeto de retorno de chamada, implementado pelo aplicativo. Use essa interface para obter notificações de evento do objeto player MFPlay. Este parâmetro pode ser NULL. Se o parâmetro for NULL, o aplicativo não receberá notificações de evento do objeto player.

[in] hWnd

Um identificador para uma janela em que o vídeo será exibido. Para reprodução somente áudio, esse parâmetro pode ser NULL.

A janela especificada por hWnd é usada para o primeiro fluxo de vídeo selecionado na origem. Se a origem tiver vários fluxos de vídeo, você deverá chamar IMFPMediaItem::SetStreamSink para renderizar qualquer um dos fluxos de vídeo após o primeiro.

Se hWnd for NULL, o MFPlay não exibirá nenhum vídeo, a menos que o aplicativo chame IMFPMediaItem::SetStreamSink para especificar um coletor de mídia para o fluxo de vídeo.

[out] ppMediaPlayer

Recebe um ponteiro para a interface IMFPMediaPlayer . O chamador deve liberar a interface. Este parâmetro pode ser NULL. Se esse parâmetro for NULL, fStartPlayback deverá ser TRUE e pwszURL não poderá ser NULL.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Antes de chamar essa função, chame CoIntialize(Ex) do mesmo thread para inicializar a biblioteca COM.

Internamente, MFPCreateMediaPlayer chama MFStartup para inicializar a plataforma Microsoft Media Foundation. Quando o objeto player é destruído, ele chama MFShutdown para desligar a plataforma. Não é necessário que um aplicativo chame MFStartup ou MFShutdown ao usar MFPlay.

Nota Se você usar outras APIs do Media Foundation fora do tempo de vida do objeto player, seu aplicativo deverá chamar MFStartup e MFShutdown.

 

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
Biblioteca	Mfplay.lib
DLL	Mfplay.dll

Confira também

Funções do Media Foundation

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