Compartilhar via


Subobjetos

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

[Não há suporte para essa API e pode ser alterada ou indisponível no futuro.]

Fontes, efeitos e transições têm ponteiros internos para outros objetos COM, chamados subobjetos. O subobjeto executa o trabalho real do objeto . O subobjeto de uma fonte é o componente que cria os dados de áudio ou vídeo. O subobjeto de um efeito ou transição é o componente que transforma os dados; por exemplo, em um efeito de vídeo, ele cria o efeito visual no fluxo de vídeo.

O tipo de subobjeto depende do tipo de objeto:

  • Origem: qualquer filtro de origem ou filtro de analisador do DirectShow que dê suporte à busca e produz um formato compatível com o DES. Pode ser um formato compactado se houver filtros directShow para decodificá-lo.
  • Efeito: para vídeo, qualquer objeto 2D one-input Microsoft® DirectX® Transform. Para áudio, qualquer filtro de efeito de áudio do DirectShow.
  • Transição: para vídeo, qualquer objeto DirectX Transform de duas entradas 2D. O áudio não dá suporte a transições.

Grupos, composições e faixas não têm subobjetos.

O aplicativo não define diretamente o ponteiro do subobjeto. Para efeitos e transições, o aplicativo chama o método IAMTimelineObj::SetSubObjectGUID para especificar o GUID do subobjeto. Para objetos de origem, um aplicativo normalmente chama IAMTimelineSrc::SetMediaName para especificar o nome de um arquivo de origem. No entanto, o método SetSubObjectGUID também pode ser usado para objetos de origem, para especificar o CLSID (identificador de classe) de um filtro.

Para obter mais informações, consulte Trabalhando com fontes e Trabalhando com efeitos e transições.

Visão geral dos componentes da linha do tempo