 Important: |
|---|
| 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. |
You set and retrieve surface color controls through the IDirectDrawColorControlinterface, which can be retrieved by querying the DirectDrawSurface object using the IID_IDirectDrawColorControlreference identifier.
Color control information is represented by a DDCOLORCONTROLstructure, which is used with both methods of the interface, IDirectDrawColorControl::SetColorControlsand IDirectDrawColorControl::GetColorControls. The first structure member, dwSize, should be set to the size of the structure, in bytes, before you use it. How you use the next member, dwFlags, depends on whether you are setting or retrieving color controls. If you are setting new color controls, set dwFlagsto a combination of the appropriate flags to indicate which of the other structure members contain valid data that you've set. However, when retrieving color controls, you don't need to set the dwFlagsbefore using itit will contain flags telling you which members are valid after the IDirectDrawColorControl::GetColorControlsmethod returns.
The remaining DDCOLORCONTROLstructure members can contain values that describe the brightness, contrast, hue, saturation, sharpness, gamma, and whether color is used.
Last updated on Tuesday, May 18, 2004