Interface IRenderEngine
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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.]
A IRenderEngine interface renderiza um projeto de DES (DirectShow Editing Services) construindo um grafo de filtro de um linha do tempo.
O DES fornece dois componentes que implementam essa interface:
- O mecanismo de renderização básico cria uma saída descompactada. Você pode usar a saída para visualização ou roteá-la por meio de filtros de compactação e gravá-la em um arquivo.
- O mecanismo de renderização inteligente cria saída compactada usando recompactação inteligente. Com a recompactação inteligente, um arquivo de origem será recompactado somente se o formato for diferente do formato de saída. Uma origem com um formato correspondente é gravada diretamente no arquivo de saída. Dependendo do cenário, a recompactação inteligente pode melhorar muito o tempo de renderização.
O mecanismo de renderização inteligente também dá suporte à interface ISmartRenderEngine .
Embora um aplicativo possa criar um grafo de filtro e passá-lo para um mecanismo de renderização, o cenário típico é que o mecanismo de renderização crie o grafo de filtro. A criação do grafo é um processo de dois estágios. Primeiro, crie o front-end chamando o método IRenderEngine::ConnectFrontEnd . Em seguida, conecte os pinos de saída no front-end aos filtros de renderização desejados:
- Renderizadores de áudio e vídeo para visualização ou
- Compressores, multiplexadores e gravadores de arquivos para gerar a saída final.
Membros
A interface IRenderEngine herda da interface IUnknown . O IRenderEngine também tem esses tipos de membros:
Métodos
A interface IRenderEngine tem esses métodos.
| Método | Descrição |
|---|---|
| Commit | Não implementado. |
| ConnectFrontEnd | Cria o front-end do grafo de filtro do linha do tempo atual. |
| Decommit | Não implementado. |
| DoSmartRecompression | Não há suporte. |
| Getcaps | Não implementado. |
| GetFilterGraph | Recupera o grafo de filtro que o mecanismo de renderização construiu, se houver. |
| GetGroupOutputPin | Recupera o pino de saída do grupo especificado. |
| GetTimelineObject | Recupera o linha do tempo que o mecanismo de renderização está usando no momento. |
| GetVendorString | Recupera a cadeia de caracteres do fornecedor. |
| RenderOutputPins | Cria a parte de visualização do grafo de filtro. |
| ScrapIt | Descarta o grafo de filtro do mecanismo de renderização e todos os objetos associados. |
| SetDynamicReconnectLevel | Define o nível de reconexão dinâmica durante a renderização. |
| SetFilterGraph | Especifica um grafo de filtro para o mecanismo de renderização a ser usado. |
| SetInterestRange | Não há suporte. |
| SetInterestRange2 | Não há suporte. |
| SetRenderRange | Define o intervalo de tempo a ser renderizado. |
| SetRenderRange2 | Define o intervalo de tempo a ser renderizado, como um duplo. |
| SetSourceConnectCallback | Não há suporte. |
| SetSourceNameValidation | Especifica como o mecanismo de renderização valida nomes de arquivo. |
| SetTimelineObject | Define o linha do tempo para o mecanismo de renderização a ser usado. |
| UseInSmartRecompressionGraph | Não há suporte. |
Comentários
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