Método CBaseControlWindow.SetWindowForeground

[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 SetWindowForeground método mueve la ventana de vídeo al primer plano y, opcionalmente, le da el foco.

Sintaxis

HRESULT SetWindowForeground(
   long Focus
);

Parámetros

Foco

Valor que especifica si la ventana de vídeo obtendrá el foco. Un valor de 1 proporciona el foco de la ventana y 0 no.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
NOERROR	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	El foco no es igual a 1 o 0.
VFW_E_NOT_CONNECTED	El filtro actual no está conectado a un gráfico de filtros completo.

Requisitos

Requisito	Value
Encabezado	Ctlutil.h (include Streams.h)
Biblioteca	Strmbase.lib (compilaciones comerciales); Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseControlWindow (clase)