|This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.|
Through the color control interface, DirectDrawSurface objects enable you to change how the system displays the contents of the surface, without affecting the contents of the surface itself. You can think of these controls as very simple filters that DirectDraw applies to the data as it leaves a surface before being rendered on the screen. Surface objects implement the IDirectDrawColorControlinterface which expose methods to adjust how the surface's contents are filtered. You can retrieve a pointer to this interface by using the IUnknown::QueryInterfacemethod of the target surface, specifying the IID_IDirectDrawColorControlreference identifier.
The IDirectDrawColorControlinterface allows you to control color in a surface much like the color controls you might find on a television. The similarity between IDirectDrawColorControland the actual controls on a TV is no mistakethis interface is most appropriate for adjusting how broadcast video looks in an overlay surface, so it makes sense that it should provide similar control over colors. You can use color controls to allow a user to change video characteristics such as hue, saturation, contrast, and several others. For more information, see Using Color Controls.
Last updated on Tuesday, May 18, 2004