Compartilhar via

Interface IRenderEngine

  • Artigo

[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
Qedit.h
Biblioteca
Strmiids.lib

Confira também

Renderizando um projeto