Função MFCreatePMPMediaSession (mfidl.h)

  • Artigo

Cria uma instância da Sessão de Mídia dentro de um processo de PMP (Caminho de Mídia Protegido).

Sintaxe

HRESULT MFCreatePMPMediaSession(
  DWORD           dwCreationFlags,
  IMFAttributes   *pConfiguration,
  IMFMediaSession **ppMediaSession,
  IMFActivate     **ppEnablerActivate
);

Parâmetros

dwCreationFlags

Um membro da enumeração MFPMPSESSION_CREATION_FLAGS que especifica como criar o objeto de sessão.

pConfiguration

Um ponteiro para a interface IMFAttributes . Este parâmetro pode ser NULL. Consulte Observações.

ppMediaSession

Recebe um ponteiro para a interface IMFMediaSession da Sessão de Mídia do PMP. O chamador deve liberar a interface . Antes de liberar a última referência ao ponteiro IMFMediaSession , o aplicativo deve chamar o método IMFMediaSession::Shutdown .

ppEnablerActivate

Recebe um ponteiro para a interface IMFActivate ou o valor NULL. Se não for NULL, o chamador deverá liberar a interface . Consulte Observações.

Valor retornado

A função 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
 A função foi bem-sucedida.

Comentários

Você pode usar o parâmetro pConfiguration para definir qualquer um dos seguintes atributos:

Se essa função não puder criar a Sessão de Mídia pmp porque um binário confiável foi revogado, o parâmetro ppEnablerActivate receberá um ponteiro de interface IMFActivate . O aplicativo pode usar esse ponteiro para criar um objeto habilitador de conteúdo, que pode ser usado para baixar um binário atualizado:
  1. Chame IMFActivate::ActivateObject com o identificador de interface IID_IMFContentEnabler para obter um ponteiro de interface IMFContentEnabler .
  2. Use essa interface para baixar o binário atualizado.
  3. Chame MFCreatePMPMediaSession novamente.
Se a função criar com êxito a Sessão de Mídia PMP, o parâmetro ppEnablerActivate receberá o valor NULL.

Não faça chamadas para a Sessão de Mídia PMP de um thread que esteja processando uma mensagem de janela enviada de outro thread. Para testar se o thread atual se enquadra nessa categoria, chame InSendMessage.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mf.lib
DLL Mf.dll

Confira também

MFCreateMediaSession

Funções do Media Foundation

Sessão de Mídia PMP

Caminho de mídia protegido