CTransformFilter (clase)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La CTransformFilter clase es una clase base para implementar filtros de transformación. Esta clase está diseñada para implementar un filtro de transformación con un pin de entrada y un pin de salida. Usa asignadores independientes para el pin de entrada y el pin de salida. Para crear un filtro que procese los datos en su lugar, use la clase CTransInPlaceFilter .

Este filtro usa la clase CTransformInputPin para su pin de entrada y la clase CTransformOutputPin para su pin de salida. Normalmente, no es necesario invalidar estas clases de patillas. La mayoría de los métodos pin llaman a los métodos correspondientes en la CTransformFilter clase , por lo que puede invalidar los métodos de filtro si es necesario. El filtro crea ambos pines en el método CTransformFilter::GetPin . Si invalida las clases de anclaje, debe invalidar GetPin para crear los pines personalizados.

Para usar esta clase, derive una nueva clase de CTransformFilter e implemente los métodos siguientes:

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

Es posible que también tenga que invalidar otros métodos, en función de los requisitos del filtro.

Tipos de medios

El pin de entrada de este filtro no propone ningún tipo de medio; se basa en el filtro ascendente para proponer los tipos de medios para la conexión. El motivo de este diseño es que, en la mayoría de los casos, el filtro ascendente puede proporcionar más información sobre el formato. Por ejemplo, con formatos de vídeo, el filtro ascendente conoce las dimensiones de vídeo y la velocidad de fotogramas, mientras que el filtro de transformación no tiene forma de determinar esta información. Si desea cambiar este comportamiento, invalide el método GetMediaType del pin de entrada. Cuando el filtro ascendente propone un tipo de medio, el pin de entrada llama al método CheckInputType del filtro (virtual puro).

Hasta que se conecte el pin de entrada, el pin de salida rechaza todas las conexiones y no devuelve ningún tipo de medio preferido. Una vez conectado el pin de entrada, el pin de salida devuelve una lista de tipos preferidos mediante una llamada al método GetMediaType del filtro. Comprueba los tipos de salida de la conexión a través del método CheckTransform del filtro. (Ambos métodos son virtuales puros). Normalmente, el tipo de entrada determinará en parte los tipos de salida aceptables.

En función del filtro, es posible que desee registrar algunos de los tipos de medios admitidos del filtro para que el objeto Filter Mapper pueda localizar el filtro. Para obtener más información, vea Cómo registrar filtros directShow.

Streaming

Esta clase no pone en cola los datos de salida. Cada ejemplo de salida se entrega dentro del método IMemInputPin::Receive . El método Receive llama al método Transform del filtro (también virtual puro) para procesar los datos.

Para obtener más información sobre el uso de esta clase, vea Escribir filtros de transformación.

Requisitos