Usando o GraphEdit

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize 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.]

GraphEdit está disponível no Microsoft Windows Software Development Kit (SDK) (https://go.microsoft.com/fwlink/p/?linkid=62332).

O nome do aplicativo GraphEdit é "graphedt.exe". Depois de instalar o SDK, "graphedt.exe" está localizado no seguinte diretório: \Program Files (x86)\Windows Kits\10\bin\<sdk version>\x64\.

Antes de executar o GraphEdit, use o utilitário regsvr32 para registrar as seguintes DLLs, que estão localizadas no mesmo diretório:

• proppage.dll
• evrprop.dll

Essas DLLs permitem que o GraphEdit exiba páginas de propriedades para alguns dos filtros DirectShow internos.

Criar um gráfico de reprodução de arquivos

O GraphEdit pode criar um gráfico de filtro para reprodução de ficheiros. Esse recurso é equivalente a chamar o IGraphBuilder::RenderFile método em um aplicativo. No menu Arquivo, clique em Renderizar arquivo de mídia. O GraphEdit exibe uma caixa de diálogo Abrir ficheiro. Selecione um arquivo multimídia e clique em Abrir. O GraphEdit cria um gráfico de filtro para reproduzir o arquivo selecionado.

Você também pode renderizar um arquivo de mídia localizado em uma URL. No menu Arquivo, clique em URL de renderização. GraphEdit exibe uma caixa de diálogo na qual digitar o URL.

Criar um gráfico de filtro

GraphEdit pode construir um gráfico de filtro personalizado, usando qualquer um dos filtros registrados em seu sistema. No menu Graph, clique em Insert Filters. É apresentada uma caixa de diálogo com uma lista dos filtros no seu sistema, organizada por categoria de filtro. O GraphEdit cria esta lista a partir de informações no registo. A ilustração a seguir mostra a caixa de diálogo.

Para adicionar um filtro ao gráfico, selecione o nome do filtro e clique no botão Inserir Filtros ou clique duas vezes no nome do filtro. Depois de adicionar os filtros, você pode conectar dois filtros arrastando o mouse do pino de saída de um filtro para o pino de entrada de outro filtro. Se os pinos aceitarem a conexão, o GraphEdit desenhará uma seta conectando-os.

Executar o gráfico

Depois de criar um gráfico de filtro no Graph Edit, você pode executá-lo para ver se ele funciona como esperado. O menu Graph contém as opções de menu Reproduzir, Pausare Parar. Esses comandos invocam os métodos do IMediaControl: Executar, Pausare Parar, respectivamente. A barra de ferramentas GraphEdit também tem botões para esses comandos:

Se o gráfico for pesquisável, você pode procurá-lo arrastando a barra deslizante que aparece abaixo da barra de ferramentas. Arrastar a barra deslizante invoca o método IMediaSeeking::SetPositions.

Ver Páginas de Propriedades

Alguns filtros suportam páginas de propriedades personalizadas, que fornecem uma interface de usuário para definir propriedades no filtro. Para exibir a página de propriedades de um filtro no GraphEdit, clique com o botão direito do mouse no filtro e selecione Propriedades na janela pop-up. GraphEdit exibe uma página de propriedades que contém as folhas de propriedades definidas pelo filtro (se houver). Além disso, o GraphEdit inclui uma folha de propriedades para cada pino no filtro. As folhas de propriedades do pino são definidas pelo GraphEdit, não pelo filtro. Se o pino estiver conectado, a folha de propriedades do pino exibirá o tipo de mídia para a conexão. Caso contrário, ele lista os tipos de mídia preferidos do pino.

Tópicos relacionados

Simulando a construção de gráficos com o GraphEdit