This method retrieves the current color control settings associated with the specified overlay or primary surface.

HRESULT GetColorControls(


  • ppColorControl
    [out] Address of the DDCOLORCONTROL structure that will receive the current control settings of the specified surface. The dwFlags member of the DDCOLORCONTROL structure indicates which of the color control options are supported.

Return Values

Returns an HRESULT value that depends on the implementation of the interface.

In the current DirectShow implementation, this method returns NOERROR if successful, or E_INVALIDARG or E_FAIL upon failure.


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

IVPNotify Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.