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 |
|---|---|
|
Êxito. |
|
A parte de renderização do grafo foi excluída. |
|
Nenhum linha do tempo definido para este mecanismo de renderização. |
|
Falha ao inicializar o mecanismo de renderização. |
|
Falha na operação porque o projeto não foi renderizado com êxito. |
|
Erro inesperado. |
|
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 |
|
| Biblioteca |
|
Confira também