CBaseControlVideo (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 clase CBaseControlVideo implementa la interfaz IBasicVideo y controla las propiedades de vídeo de una ventana de vídeo genérica. Por lo general, un objeto CBaseControlVideo es un representador de vídeo que dibuja vídeo en una ventana de la pantalla.

Muchas funciones miembro CBaseControlVideo solo requieren que el representador de vídeo esté conectado a un grafo de filtro. Si no está conectado, las funciones miembro devolverán VFW_E_NOT_CONNECTED. Las propiedades establecidas en un representador de vídeo persisten entre conexiones sucesivas y desconexiones. Todas las aplicaciones deben asegurarse de que restablecen las propiedades del representador antes de iniciar una presentación.

Al trabajar con vídeo, la aplicación puede seleccionar una parte del vídeo que se va a usar. Esta parte es el rectángulo de origen que controla el objeto CBaseControlVideo . CBaseControlVideo permite que la aplicación establezca y recupere el rectángulo de origen. Todos los rectángulos que CBaseControlVideo usa usan valores de ancho y alto en lugar de valores derecho e inferior. Cuando no se ha establecido ningún rectángulo de origen, las propiedades del rectángulo de origen devuelven el tamaño de vídeo nativo completo.

Miembros de datos protegidos	Descripción
m_pFilter	Puntero a un filtro multimedia propietario.
m_pInterfaceLock	Sección crítica definida externamente.
m_pPin	Control de los tipos de medios para la conexión.
Funciones de miembro	Descripción
CBaseControlVideo	Construye un objeto CBaseControlVideo .
CopyImage	Crea una copia de memoria de una imagen de vídeo.
GetImageSize	Recupera información de tamaño de imagen de vídeo.
SetControlVideoPin	Establece el pin con el que se debe sincronizar este objeto.
Funciones miembro reemplazables	Descripción
CheckSourceRect	Determina si un rectángulo de origen es válido.
CheckTargetRect	Determina si un rectángulo de destino es válido.
GetSourceRect	Recupera el rectángulo de vídeo de origen actual (virtual puro).
GetStaticImage	Devuelve la imagen actual en un búfer de memoria (virtual puro).
GetTargetRect	Recupera el rectángulo de vídeo de destino actual (virtual puro).
GetVideoFormat	Recupera la estructura VIDEOINFOHEADER que contiene el formato de vídeo.
IsDefaultSourceRect	Determina si el representador usa el rectángulo de origen predeterminado (virtual puro).
IsDefaultTargetRect	Determina si el representador usa el rectángulo de destino predeterminado (virtual puro).
OnUpdateRectangles	Se llama cuando cambia el rectángulo de origen o de destino.
OnVideoSizeChange	Pasa EC_VIDEO_SIZE_CHANGED a la aplicación.
SetDefaultSourceRect	Establece el rectángulo de vídeo de origen predeterminado (virtual puro).
SetDefaultTargetRect	Establece el rectángulo de vídeo de destino predeterminado (virtual puro).
SetSourceRect	Establece el rectángulo de vídeo de origen actual (virtual puro).
SetTargetRect	Establece el rectángulo de destino actual (virtual puro).
Métodos IBasicVideo	Descripción
get_AvgTimePerFrame	Recupera un tiempo medio aproximado por fotograma.
get_BitErrorRate	Recupera una tasa de errores de bits aproximada.
get_BitRate	Recupera una velocidad de bits aproximada para el vídeo.
GetCurrentImage	Recupera una representación de memoria de la imagen actual.
get_DestinationHeight	Recupera el alto del rectángulo de destino actual.
get_DestinationLeft	Recupera la coordenada izquierda del rectángulo de destino actual.
GetDestinationPosition	Recupera la posición de destino actual.
get_DestinationTop	Recupera la coordenada superior del rectángulo de destino actual.
get_DestinationWidth	Recupera el ancho del rectángulo de destino actual.
get_SourceHeight	Recupera el alto del rectángulo de origen actual.
get_SourceLeft	Recupera la coordenada izquierda del rectángulo de origen actual.
GetSourcePosition	Recupera la posición de origen actual.
get_SourceTop	Recupera la coordenada superior del rectángulo de origen actual.
get_SourceWidth	Recupera el ancho del rectángulo de origen actual.
get_VideoHeight	Recupera el alto de vídeo nativo.
GetVideoPaletteEntries	Recupera un intervalo de entradas de paleta para el vídeo.
GetVideoSize	Recupera el ancho y alto del vídeo nativo.
get_VideoWidth	Recupera el ancho del vídeo nativo.
IsUsingDefaultDestination	Determina si el representador usa la ventana de destino predeterminada.
IsUsingDefaultSource	Determina si el representador usa la ventana de origen predeterminada.
put_DestinationHeight	Establece el alto del rectángulo de destino.
put_DestinationLeft	Establece la coordenada izquierda del rectángulo de destino.
put_DestinationTop	Establece la coordenada superior del rectángulo de destino.
put_DestinationWidth	Establece el ancho del rectángulo de destino.
put_SourceHeight	Establece el alto del rectángulo de origen.
put_SourceLeft	Establece la coordenada izquierda del rectángulo de origen.
put_SourceTop	Establece la coordenada superior del rectángulo de origen.
put_SourceWidth	Establece el ancho del rectángulo de origen.
SetDefaultDestinationPosition	Vuelve a establecer la posición de destino predeterminada.
SetDefaultSourcePosition	Vuelve a establecer la posición de origen predeterminada.
SetDestinationPosition	Establece la posición del rectángulo de destino.
SetSourcePosition	Establece la posición del rectángulo de origen.

 

Consulte también

Clases base directShow