Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The SetOverlayColorControls function changes color-control settings for the given overlay.
Syntax
PFND3DDDI_SETOVERLAYCOLORCONTROLS Pfnd3dddiSetoverlaycolorcontrols;
HRESULT Pfnd3dddiSetoverlaycolorcontrols(
HANDLE hDevice,
const D3DDDIARG_SETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
Parameters
hDevice
A handle to the display device (graphics context).
unnamedParam2
pData [in]
A pointer to a D3DDDIARG_SETOVERLAYCOLORCONTROLS structure that describes parameters for changing an overlay's color-control settings.
Return value
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. |
Remarks
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Target Platform | Desktop |
| Header | d3dumddi.h (include D3dumddi.h) |