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:

• Para visualizar, chame o método IRenderEngine::RenderOutputPins .
• Para gerar um arquivo, chame IRenderEngine::GetGroupOutputPin para recuperar o pino de saída de cada grupo e conecte os pinos a um filtro multiplexer.

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