CBaseControlWindow (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 CBaseControlWindow implementa la interfaz IVideoWindow y controla el acceso externo a su filtro asociado. Debe sincronizar el objeto CBaseControlWindow con el filtro pasando un puntero a un objeto de sincronización de sección crítica. La clase CBaseControlWindow proporciona una serie de métodos que devuelven la configuración de propiedad sin tratar con esta sección crítica. Por ejemplo, al llamar a CBaseControlWindow::get_AutoShow para recuperar el valor del miembro de datos de m_bAutoShow bloquea la sección crítica. Sin embargo, es posible que el filtro ya tenga una sección crítica interna bloqueada, lo que podría infringir la jerarquía de bloqueos del filtro. En su lugar, llamar a la función miembro CBaseControlWindow::IsAutoShowEnabled devuelve el valor necesario sin afectar a la sección crítica.

Todos los métodos IVideoWindow implementados de CBaseControlWindow requieren que el filtro se conecte correctamente con su filtro ascendente. Por este motivo, los objetos de clase requieren un pin de sincronización, que se establece llamando al método CBaseControlWindow::SetControlWindowPin . Cada vez que se llama a un método IVideoWindow , el objeto CBaseControlWindow comprueba que el pin todavía está conectado.

Miembros de datos protegidos	Descripción
m_bAutoShow	Resultado cuando cambia el estado.
m_bCursorHidden	Determinación de si el cursor se muestra u oculta.
m_BorderColour	Color del borde de la ventana actual.
m_hwndDrain	Identificador de ventana al que se publican los mensajes recibidos.
m_hwndOwner	Ventana propietaria.
m_pFilter	Puntero al filtro de medios 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
CBaseControlWindow	Construye un objeto CBaseControlWindow .
DoGetWindowStyle	Recupera los estilos de ventana típicos o extendidos.
DoSetWindowStyle	Establece los estilos de ventana típicos o extendidos.
GetBorderColour	Recupera el color del borde actual. Se trata de una función miembro auxiliar.
GetOwnerWindow	Recupera la ventana propietaria. Se trata de una función miembro auxiliar.
IsAutoShowEnabled	Recupera información sobre si la ventana de vídeo aparece automáticamente cuando el filtro de representación se pausa o se ejecuta.
IsCursorHidden	Recupera el estado actual del miembro de datos m_bCursorHidden sin bloquear la sección crítica. Se trata de una función miembro auxiliar.
PosiblementeEatMessage	Distribuye los mensajes a la ventana primaria.
SetControlWindowPin	Notifica al objeto del pin al que se aplica.
Métodos IVideoWindow	Descripción
get_AutoShow	Recupera la configuración actual de la marca AutoShow.
get_BackgroundPalette	Recupera la paleta realizada en la marca de fondo.
get_BorderColor	Recupera el color del borde actual.
get_Caption	Recupera la ventana actual subtítulo.
get_ FullScreenMode	Recupera el modo de pantalla completa actual.
get_Height	Recupera el alto de la ventana actual.
get_Left	Recupera la coordenada de la ventana izquierda actual.
GetMaxIdealImageSize	Recupera el tamaño máximo de la imagen ideal.
get_MessageDrain	Recupera el purgado de mensajes actual.
GetMinIdealImageSize	Recupera el tamaño mínimo de la imagen ideal.
get_Owner	Recupera el identificador de la ventana primaria.
GetRestorePosition	Recupera la posición a la que se restaurará la ventana cuando se maximice o minimice.
get_Top	Recupera la coordenada y de la parte superior de la ventana.
get_Visible	Recupera la configuración de visibilidad actual de la ventana.
get_Width	Recupera el ancho de la ventana.
GetWindowPosition	Recupera las coordenadas de la ventana actual.
get_WindowState	Recupera el estado actual de la ventana.
get_WindowStyle	Recupera los estilos de ventana estándar.
get_WindowStyleEx	Recupera los estilos de ventana extendidos.
HideCursor	Oculta o muestra el cursor.
IsCursorHidden	Recupera el estado actual del miembro de datos m_bCursorHidden .
NotifyOwnerMessage	Pasa mensajes que se envían a ventanas propietarias.
put_AutoShow	Establece la propiedad AutoShow.
put_BackgroundPalette	Establece una marca para darse cuenta de la paleta en segundo plano.
put_BorderColor	Establece el color del borde actual.
put_Caption	Establece la ventana actual subtítulo.
put_ FullScreenMode	Establece el modo de pantalla completa.
put_Height	Establece el alto de la ventana actual.
put_Left	Establece la coordenada izquierda de la ventana.
put_MessageDrain	Establece la ventana de purga de mensajes.
put_Owner	Establece el identificador de ventana principal de Microsoft Win32.
put_Top	Establece la posición de la parte superior de la ventana.
put_Visible	Oculta o muestra la ventana.
put_Width	Establece el ancho de la ventana.
put_WindowState	Establece el estado de la ventana.
put_WindowStyle	Establece los estilos de ventana estándar.
put_WindowStyleEx	Establece los estilos de ventana extendidos.
SetWindowForeground	Establece la ventana en primer plano.
SetWindowPosition	Establece la posición de la ventana.

 

Consulte también

Clases base directShow