Interfaz IBasicVideo (control.h)

[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 IBasicVideo interfaz establece propiedades de vídeo como el destino y los rectángulos de origen. El filtro Video Renderer y los filtros del representador de mezcla de vídeo implementan esta interfaz, pero la interfaz se expone a las aplicaciones a través del Administrador de gráficos de filtros. Las aplicaciones siempre deben recuperar esta interfaz del Administrador de gráficos de filtros.

La IBasicVideo interfaz manipula los rectángulos siguientes asociados a la imagen de vídeo:

• El rectángulo de origen es la parte de la imagen original que se muestra.
• El rectángulo de destino es la parte de la ventana de vídeo que recibe el rectángulo de origen.
• El rectángulo de vídeo es la imagen de vídeo original.

En otras palabras, el representador de vídeo recorta la imagen en el rectángulo de origen y, a continuación, estira o reduce la imagen recortada al rectángulo de destino. Todas las dimensiones del rectángulo se proporcionan en píxeles.

Las propiedades establecidas en Video Renderer persisten entre las conexiones sucesivas y las desconexiones.

Códigos de error: si el filtro del representador de vídeo no está conectado a otro filtro, todos los métodos devuelven el código de error VFW_E_NOT_CONNECTED. Para la implementación de Filter Graph Manager, si el grafo no contiene un filtro de representador de vídeo, todos los métodos devuelven E_NOINTERFACE. Tenga en cuenta que el Administrador de gráficos de filtros expone la interfaz incluso cuando el grafo no contiene un representador de vídeo, por lo que una aplicación puede consultar la interfaz antes de compilar el gráfico.

Herencia

La interfaz IBasicVideo hereda de la interfaz IDispatch . IBasicVideo también tiene estos tipos de miembros:

Métodos

La interfaz IBasicVideo tiene estos métodos.

IBasicVideo::get_AvgTimePerFrame El método get_AvgTimePerFrame recupera el tiempo medio entre fotogramas sucesivos.
IBasicVideo::get_BitErrorRate El método get_BitErrorRate recupera la velocidad de error de bits aproximada de la secuencia de vídeo.
IBasicVideo::get_BitRate El método get_BitRate recupera la velocidad de bits aproximada de la secuencia de vídeo.
IBasicVideo::get_DestinationHeight El método get_DestinationHeight recupera el alto del rectángulo de destino.
IBasicVideo::get_DestinationLeft El método get_DestinationLeft recupera la coordenada x del rectángulo de destino.
IBasicVideo::get_DestinationTop El método get_DestinationTop recupera la coordenada y del rectángulo de destino.
IBasicVideo::get_DestinationWidth El método get_DestinationWidth recupera el ancho del rectángulo de destino.
IBasicVideo::get_SourceHeight El método get_SourceHeight recupera el alto del rectángulo de origen.
IBasicVideo::get_SourceLeft El método get_SourceLeft recupera la coordenada x del rectángulo de origen.
IBasicVideo::get_SourceTop El método get_SourceTop recupera la coordenada y del rectángulo de origen.
IBasicVideo::get_SourceWidth El método get_SourceWidth recupera el ancho del rectángulo de origen.
IBasicVideo::get_VideoHeight El método get_VideoHeight recupera el alto nativo del vídeo.
IBasicVideo::get_VideoWidth El método get_VideoWidth recupera el ancho nativo del vídeo.
IBasicVideo::GetCurrentImage El método GetCurrentImage recupera la imagen actual en espera en el representador.
IBasicVideo::GetDestinationPosition El método GetDestinationPosition recupera la posición del rectángulo de destino.
IBasicVideo::GetSourcePosition El método GetSourcePosition recupera la posición del rectángulo de origen.
IBasicVideo::GetVideoPaletteEntries El método GetVideoPaletteEntries recupera los colores de paleta del vídeo.
IBasicVideo::GetVideoSize El método GetVideoSize recupera las dimensiones de vídeo nativas.
IBasicVideo::IsUsingDefaultDestination El método IsUsingDefaultDestination consulta si el representador usa el rectángulo de destino predeterminado.
IBasicVideo::IsUsingDefaultSource El método IsUsingDefaultSource consulta si el representador usa el rectángulo de origen predeterminado.
IBasicVideo::p ut_DestinationHeight El método put_DestinationHeight establece el alto del rectángulo de destino.
IBasicVideo::p ut_DestinationLeft El método put_DestinationLeft establece la coordenada x del rectángulo de destino.
IBasicVideo::p ut_DestinationTop El método put_DestinationTop establece la coordenada y del rectángulo de destino.
IBasicVideo::p ut_DestinationWidth El método put_DestinationWidth establece el ancho del rectángulo de destino.
IBasicVideo::p ut_SourceHeight El método put_SourceHeight establece el alto del rectángulo de origen.
IBasicVideo::p ut_SourceLeft El método put_SourceLeft establece la coordenada x del rectángulo de origen.
IBasicVideo::p ut_SourceTop El método put_SourceTop establece la coordenada y del rectángulo de origen.
IBasicVideo::p ut_SourceWidth El método put_SourceWidth establece el ancho del rectángulo de origen.
IBasicVideo::SetDefaultDestinationPosition El método SetDefaultDestinationPosition vuelve al rectángulo de destino predeterminado. Después de llamar a este método, el representador de vídeo usa toda la ventana para la reproducción.
IBasicVideo::SetDefaultSourcePosition El método SetDefaultSourcePosition vuelve al rectángulo de origen predeterminado. Después de llamar a este método, el representador de vídeo usa toda la imagen de vídeo, sin recortar.
IBasicVideo::SetDestinationPosition El método SetDestinationPosition establece el rectángulo de destino.
IBasicVideo::SetSourcePosition El método SetSourcePosition establece el rectángulo de origen.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	control.h (include Dshow.h)

Consulte también

IDispatch