Método IRenderEngine::SetFilterGraph
[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 SetFilterGraph método especifica um grafo de filtro para o mecanismo de renderização a ser usado.
Sintaxe
HRESULT SetFilterGraph(
IGraphBuilder *pFG
);
Parâmetros
-
Pfg
-
Ponteiro para a interface IGraphBuilder do grafo de filtro.
Retornar valor
Retorna um dos seguintes valores HRESULT :
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Argumento inválido. |
|
Falha ao inicializar o mecanismo de renderização. |
Comentários
A maioria dos aplicativos não precisa chamar esse método. É mais comum permitir que o mecanismo de renderização crie o grafo para você, chamando o método IRenderEngine::ConnectFrontEnd .
Esse método falhará se o mecanismo de renderização já tiver um grafo de filtro.
Nunca recupere um ponteiro para um grafo de filtro criado por um mecanismo de renderização e, em seguida, use-o como o parâmetro para esse método em outro mecanismo de renderização. Isso causará resultados imprevisíveis.
O método ConnectFrontEnd desmonta qualquer grafo de filtro existente, mas mantém a mesma instância do Gerenciador de Grafo de Filtro.
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