Compartilhar via


Método IRenderEngine::ConnectFrontEnd

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Observação

[Preterido. Essa API pode ser removida de versões futuras do Windows.]

 

O ConnectFrontEnd método cria o front-end do grafo de filtro do linha do tempo atual.

Sintaxe

HRESULT ConnectFrontEnd();

Parâmetros

Esse método não tem parâmetros.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores retornados incluem o seguinte:

Código de retorno Descrição
S_OK
Êxito.
S_WARN_OUTPUTRESET
A parte de renderização do grafo foi excluída.
E_INVALIDARG
Nenhum linha do tempo definido para este mecanismo de renderização.
E_MUST_INIT_RENDERER
Falha ao inicializar o mecanismo de renderização.
E_RENDER_ENGINE_IS_BROKEN
Falha na operação porque o projeto não foi renderizado com êxito.
E_UNEXPECTED
Erro inesperado.
VFW_E_INVALIDMEDIATYPE
Tipo de mídia inválido.

 

Comentários

Esse método não cria a parte de renderização do grafo de filtro. O aplicativo deve conectar os pinos de saída no front-end aos filtros de renderização desejados:

Se você estiver usando o mecanismo de renderização básico, os pinos de saída no front-end produzirão dados descompactados. Se você estiver usando o mecanismo de renderização inteligente, os pinos de saída produzirão dados compactados.

Se você alterar o linha do tempo depois de compilar o grafo de filtro, deverá chamar ConnectFrontEnd novamente para recompilar o front-end. O método preserva a parte de renderização do grafo sempre que possível. No entanto, se você adicionar ou excluir um grupo ou alterar a ordem dos grupos, ConnectFrontEnd excluirá a parte de renderização e seu aplicativo deverá recompilá-la. Se o método excluir a parte de renderização, ele retornará S_WARN_OUTPUTRESET.

Observação

O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.

 

Observação

Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito Valor
parâmetro
Qedit.h
Biblioteca
Strmiids.lib

Confira também

IRenderEngine Interface

Códigos de erro e êxito