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