Função MFPCreateMediaPlayer (mfplay.h)
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.
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de