Compartir a través de


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