Método IRenderEngine::GetFilterGraph

[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.]

O GetFilterGraph método recupera o grafo de filtro que o mecanismo de renderização construiu, se houver.

Sintaxe

HRESULT GetFilterGraph(
  [out] IGraphBuilder **ppFG
);

Parâmetros

ppFG [out]

Recebe um ponteiro para a interface IGraphBuilder do grafo de filtro. Ele receberá o valor NULL se não houver grafo de filtro.

Retornar valor

Retorna um dos seguintes valores HRESULT :

Comentários

Use o método IRenderEngine::ConnectFrontEnd para criar o front-end do grafo de filtro. Para visualização, use iRenderEngine::RenderOutputPins para concluir o grafo. Para saída de arquivo, conecte o front-end a uma combinação de gravador de arquivos/mux. Para obter mais informações, consulte Renderizando um projeto.

O grafo resultante pode ser executado, pausado, interrompido e buscado; no entanto, a taxa de reprodução não pode ser alterada.

No retorno, se o valor de *ppFG não for NULL, a interface IGraphBuilder terá uma contagem de referência pendente. Certifique-se de liberar a interface quando terminar de usá-la.

Requisitos

Confira também

IRenderEngine Interface

Códigos de erro e êxito