Método IMFMediaEngineClassFactory::CreateInstance (mfmediaengine.h)

  • Artigo

Cria uma nova instância do Mecanismo de Mídia.

Sintaxe

HRESULT CreateInstance(
  [in]  DWORD          dwFlags,
  [in]  IMFAttributes  *pAttr,
  [out] IMFMediaEngine **ppPlayer
);

Parâmetros

[in] dwFlags

Um OR bit a bit de zero ou mais sinalizadores da enumeração MF_MEDIA_ENGINE_CREATEFLAGS .

[in] pAttr

Um ponteiro para a interface IMFAttributes de um repositório de atributos.

Esse parâmetro especifica atributos de configuração para o Mecanismo de Mídia. Chame MFCreateAttributes para criar o repositório de atributos. Em seguida, defina um ou mais atributos da lista de Atributos do Mecanismo de Mídia. Para obter detalhes, consulte Observações.

[out] ppPlayer

Recebe um ponteiro para a interface IMFMediaEngine . O chamador deve liberar a interface .

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
MF_E_ATTRIBUTENOTFOUND
 Um atributo necessário estava ausente do pAttr ou uma combinação inválida de atributos foi usada.

Comentários

Antes de chamar esse método, chame MFStartup.

O Mecanismo de Mídia dá suporte a três modos distintos:

Mode Descrição
Modo de servidor de quadros Nesse modo, o Mecanismo de Mídia fornece quadros de vídeo descompactados para o aplicativo. O aplicativo é responsável por exibir cada quadro, usando o Microsoft Direct3D ou qualquer outra técnica de renderização.

O Mecanismo de Mídia renderiza o áudio; o aplicativo não é responsável pela renderização de áudio.

O modo de servidor de quadros é o modo padrão.
Modo de renderização Nesse modo, o Mecanismo de Mídia renderiza áudio e vídeo. O vídeo é renderizado em uma janela ou no visual do Microsoft DirectComposition fornecido pelo aplicativo.

Para habilitar o modo de renderização, defina o atributo MF_MEDIA_ENGINE_PLAYBACK_HWND ou o atributo MF_MEDIA_ENGINE_PLAYBACK_VISUAL .
Modo de áudio Nesse modo, o Mecanismo de Mídia renderiza somente áudio, sem vídeo.

Para habilitar o modo de áudio, defina o sinalizador MF_MEDIA_ENGINE_AUDIOONLY no parâmetro dwFlags .
 

Atributos de inicialização

Os atributos a seguir são definidos para o parâmetro pAttr . Alguns são necessários e outros são opcionais, dependendo do modo desejado.
Recurso Atributos Modo de Servidor de Quadros Modo de renderização Modo de áudio
Retorno de chamada de evento MF_MEDIA_ENGINE_CALLBACK Obrigatórios. Obrigatórios. Obrigatórios.
Destino de renderização Um dos seguintes:
MF_MEDIA_ENGINE_PLAYBACK_HWND
MF_MEDIA_ENGINE_PLAYBACK_VISUAL
Esses atributos são mutuamente exclusivos. Definir um desses atributos coloca o Mecanismo de Mídia no modo de renderização. 		Não defina. Obrigatórios. Não defina.
Formato Direct3D MF_MEDIA_ENGINE_VIDEO_OUTPUT_FORMAT Obrigatórios. Opcional. Não defina.
Gerenciador de dispositivos DXGI (Infraestrutura Gráfica do Microsoft DirectX) MF_MEDIA_ENGINE_DXGI_MANAGER Opcional. Opcional. Não defina.
Extensões do Mecanismo de Mídia MF_MEDIA_ENGINE_EXTENSION Opcional. Opcional. Opcional.
Proteção de conteúdo Um dos seguintes:
MF_MEDIA_ENGINE_OPM_HWND
MF_MEDIA_ENGINE_CONTENT_PROTECTION_FLAGS
MF_MEDIA_ENGINE_CONTENT_PROTECTION_MANAGER
Opcional. Opcional. Opcional.
Reprodução de áudio Um dos seguintes:
MF_MEDIA_ENGINE_AUDIO_CATEGORY
MF_MEDIA_ENGINE_AUDIO_ENDPOINT_ROLE
Opcional. Opcional. Opcional.
 

Windows Phone 8

Há suporte para essa API.

No telefone, o Mecanismo de Mídia dá suporte apenas ao modo de servidor de quadros. A tentativa de inicializar a interface no modo de renderização ou no modo de áudio falhará.

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfmediaengine.h

Confira também

IMFMediaEngineClassFactory