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.]
Observação
[Preterido. Essa API pode ser removida de versões futuras do Windows.]
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 :
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Falha ao inicializar o mecanismo de renderização. |
|
Ponteiro inválido. |
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.
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