Método IVideoWindow::p ut_FullScreenMode (control.h)

  • 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 put_FullScreenMode método habilita o deshabilita la representación de vídeo en pantalla completa.

Sintaxis

HRESULT put_FullScreenMode(
  [in] long FullScreenMode
);

Parámetros

[in] FullScreenMode

Valor booleano que especifica si se va a habilitar o deshabilitar el modo de pantalla completa. Debe ser uno de los siguientes valores:

Valor Descripción
OATRUE Cambie al modo de pantalla completa.
OAFALSE Deshabilite el modo de pantalla completa. (Valor predeterminado).

Valor devuelto

Entre los valores devueltos posibles se incluyen los siguientes:

Código devuelto Descripción
E_NOTIMPL
 El filtro no admite el modo de pantalla completa.
S_FALSE
 Ya está en el modo solicitado.
S_OK
 Correcto.
VFW_E_NO_FULLSCREEN
 No se encontró ningún filtro que admita el modo de pantalla completa.

Observaciones

En función del representador de vídeo, es posible que el cambio al modo de pantalla completa no sea visible hasta que la aplicación se ejecute o detenga el gráfico. En modo de pantalla completa, si el usuario se aleja de la aplicación (por ejemplo, mediante ALT + TAB), el Administrador de gráficos de filtros envía un evento EC_FULLSCREEN_LOST .

En los comentarios siguientes se describe cómo el Administrador de gráficos de filtros implementa el modo de pantalla completa. Es probable que los desarrolladores de aplicaciones omitan esta información, pero puede resultar útil si está escribiendo un representador de vídeo personalizado.

Cuando una aplicación cambia al modo de pantalla completa, el Administrador de gráficos de filtros busca un representador de vídeo que funcionará de forma más eficaz. En orden de preferencia, estos son:

  1. Cualquier representador de vídeo en el gráfico de filtros que admita de forma nativa el modo de pantalla completa.
  2. Cualquier representador de vídeo en el gráfico de filtros que pueda ampliar el vídeo a pantalla completa sin un costo de rendimiento significativo.
  3. Filtro representador de pantalla completa .
  4. Cualquier representador de vídeo en el gráfico de filtros que admita IVideoWindow.
Para la primera opción, el Administrador de gráficos de filtros llama a IVideoWindow::get_FullScreenMode en cada representador de vídeo del gráfico. La mayoría de los representadores devuelven E_NOTIMPL, lo que indica que el filtro no admite de forma nativa el modo de pantalla completa. Si algún representador devuelve un valor no igual a E_NOTIMPL, el Administrador de gráficos de filtros usa ese valor.

Para la segunda opción, el Administrador de gráficos de filtros llama a IVideoWindow::GetMaxIdealImageSize y GetMinIdealImageSize en cada representador de vídeo del gráfico. Si el tamaño de la pantalla está dentro del intervalo notificado del filtro, indica que el filtro puede estirar el vídeo sin un costo de rendimiento significativo.

Nota Si se detiene el gráfico, el Administrador de gráficos de filtros pausa cada representador antes de llamar a estos métodos. Esto ofrece al representador la oportunidad de inicializar los recursos que necesita, ya que muchos representadores no pueden determinar estos valores mientras se detienen.
 
Excepto en el hardware anterior, la segunda opción generalmente se realizará correctamente. La tercera opción es usar el filtro Representador de pantalla completa, agregándolo al gráfico si es necesario. La cuarta opción es simplemente buscar el primer representador en el gráfico que admite IVideoWindow y ampliar el vídeo independientemente del rendimiento.

Requisitos

   
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)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IVideoWindow (interfaz)

IVideoWindow::get_FullScreenMode