Compartir a través de

Método CTransformFilter.Transform

  • Artículo

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

El Transform método transforma un ejemplo de entrada para generar un ejemplo de salida.

Sintaxis

virtual HRESULT Transform(
   IMediaSample *pIn,
   IMediaSample *pOut
);

Parámetros

anclar

Puntero a la interfaz IMediaSample del ejemplo de entrada.

Puchero

Puntero a la interfaz IMediaSample del ejemplo de salida.

Valor devuelto

La clase base devuelve E_UNEXPECTED.

La clase derivada debe devolver un valor HRESULT , lo que indica que se ha realizado correctamente o no. Entre los valores posibles se incluyen los que se muestran en la tabla siguiente.

Código devuelto Descripción
S_FALSE
 No entregue este ejemplo.
S_OK
 Correcto.

Observaciones

Invalide este método para generar datos de salida. Lea los datos de entrada del ejemplo especificado por el parámetro pIn y escriba los nuevos datos en el ejemplo especificado por el parámetro pOut .

Antes de que el filtro llame a este método, copia las propiedades del ejemplo de entrada en el ejemplo de salida. El Transform método debe establecer las propiedades que difieren entre los dos ejemplos, mediante métodos IMediaSample o la interfaz IMediaSample2 (si está disponible).

Si el filtro no debe entregar este ejemplo (por ejemplo, para admitir el control de calidad), el método debe devolver S_FALSE.

Requisitos

Requisito Value
Encabezado
Transfrm.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CTransformFilter (clase)