Método IMFMediaEngineClassFactory::CreateInstance (mfmediaengine.h)
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 |
|---|---|
|
Êxito. |
|
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: 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: | Opcional. | Opcional. | Opcional. |
| Reprodução de áudio | Um dos seguintes: | 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 |