// d3dumddi.h
PFND3DDDI_SETOVERLAYCOLORCONTROLS Pfnd3dddiSetoverlaycolorcontrols;
HRESULT Pfnd3dddiSetoverlaycolorcontrols(
HANDLE hDevice,
const D3DDDIARG_SETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The SetOverlayColorControls function changes color-control settings for the given overlay.
hDeviceA handle to the display device (graphics context).
unnamedParam2pData [in]
A pointer to a D3DDDIARG_SETOVERLAYCOLORCONTROLS structure that describes parameters for changing an overlay's color-control settings.
SetOverlayColorControls returns one of the following values:
| Return code | Description |
|---|---|
| S_OK | The color-control settings were successfully changed. |
| E_INVALIDARG | Parameters were validated and determined to be incorrect. |
| E_OUTOFMEMORY | SetOverlayColorControls could not allocate the required memory for it to complete. |
The Microsoft Direct3D runtime calls the SetOverlayColorControls function to change the brightness, contrast, hue, saturation, sharpness, gamma, and color-enable settings that are associated with a specific overlay.
The runtime can also call SetOverlayColorControls for an overlay that is not yet visible. In this situation, when the hOverlay member of the D3DDDIARG_SETOVERLAYCOLORCONTROLS structure pointed to by pData is set to NULL, the driver should store the supplied color-control settings and use them when an overlay that references the specified resource is created.
D3DDDIARG_SETOVERLAYCOLORCONTROLS