This method moves the video window to the foreground and optionally gives it focus.

HRESULT SetWindowForeground(
  long Focus


  • Focus
    [in] Long value that specifies whether the video window will get focus. A value of –1 gives the window focus and 0 does not.

Return Values

Returns one of the following values.

Value Description
NOERROR The method succeeded.
E_INVALIDARG Focus does not equal –1 or 0.
VFW_E_NOT_CONNECTED The current filter is not connected to a complete filter graph.


DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IVideoWindow Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.