Classe CTransformFilter

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

A CTransformFilter classe é uma classe base para implementar filtros de transformação. Essa classe foi projetada para implementar um filtro de transformação com um pino de entrada e um pino de saída. Ele usa alocadores separados para o pino de entrada e o pino de saída. Para criar um filtro que processa dados em vigor, use a classe CTransInPlaceFilter .

Esse filtro usa a classe CTransformInputPin para seu pin de entrada e a classe CTransformOutputPin para seu pin de saída. Normalmente, você não precisa substituir essas classes de pino. A maioria dos métodos pin chama métodos correspondentes na CTransformFilter classe , para que você possa substituir os métodos de filtro, se necessário. O filtro cria ambos os pinos no método CTransformFilter::GetPin . Se você substituir as classes de pino, deverá substituir GetPin para criar seus pinos personalizados.

Para usar essa classe, derive uma nova classe de CTransformFilter e implemente os seguintes métodos:

• CTransformFilter::CheckInputType
• CTransformFilter::CheckTransform
• CTransformFilter::D ecideBufferSize
• CTransformFilter::GetMediaType
• CTransformFilter::Transform

Talvez seja necessário substituir outros métodos também, dependendo dos requisitos do filtro.

Tipos de mídia

O pin de entrada desse filtro não propõe nenhum tipo de mídia; ele depende do filtro upstream para propor os tipos de mídia para a conexão. O motivo desse design é que, na maioria dos casos, o filtro upstream pode fornecer mais informações sobre o formato. Por exemplo, com formatos de vídeo, o filtro upstream conhece as dimensões de vídeo e a taxa de quadros, enquanto o filtro de transformação não tem como determinar essas informações. Se você quiser alterar esse comportamento, substitua o método GetMediaType do pino de entrada. Quando o filtro upstream propõe um tipo de mídia, o pin de entrada chama o método CheckInputType do filtro (virtual puro).

Até que o pino de entrada seja conectado, o pino de saída recusará todas as conexões e não retornará nenhum tipo de mídia preferencial. Depois que o pino de entrada é conectado, o pino de saída retorna uma lista de tipos preferenciais chamando o método GetMediaType do filtro. Ele verifica os tipos de saída para a conexão por meio do método CheckTransform do filtro. (Ambos os métodos são virtuais puros.) Normalmente, o tipo de entrada determinará parcialmente os tipos de saída aceitáveis.

Dependendo do filtro, talvez você queira registrar alguns dos tipos de mídia com suporte do filtro, para que o objeto Filter Mapper possa localizar o filtro. Para obter mais informações, consulte Como registrar filtros do DirectShow.

Streaming

Essa classe não enfileira os dados de saída. Cada exemplo de saída é entregue dentro do método IMemInputPin::Receive . O método Receive chama o método Transform do filtro (também virtual puro) para processar os dados.

Para obter mais informações sobre como usar essa classe, consulte Escrevendo filtros de transformação.

Requisitos