Compartilhar via


Subobjects

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture 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 Audio/Video Capture 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.]

[Essa API não tem suporte e pode ser alterada ou indisponível no futuro.]

Fontes, efeitos e transições têm ponteiros internos para outros objetos COM, chamados de subobjetos . O subobjeto executa o trabalho real do objeto. O subobjeto de uma origem é 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 do DirectShow para decodificá-lo.
  • Efeito: para vídeo, qualquer objeto de transformação Microsoft® DirectX® de entrada 2D. 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 de 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 o 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