PFND3DDDI_GETOVERLAYCOLORCONTROLS回呼函式 (d3dumddi.h)
GetOverlayColorControls 函式會擷取指定重疊的色彩控制設定。
語法
PFND3DDDI_GETOVERLAYCOLORCONTROLS Pfnd3dddiGetoverlaycolorcontrols;
HRESULT Pfnd3dddiGetoverlaycolorcontrols(
HANDLE hDevice,
D3DDDIARG_GETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄 (圖形內容) 。
unnamedParam2
pData [in， out]
D3DDDIARG_GETOVERLAYCOLORCONTROLS 結構的指標，描述擷取重疊色彩控件設定的參數。
傳回值
GetOverlayColorControls 會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| S_OK | 已成功擷取色彩控件設定。 |
| E_INVALIDARG | 已驗證參數，並判斷為不正確。 |
| E_OUTOFMEMORY | GetOverlayColorControls 無法為其配置必要的記憶體以完成。 |
備註
Microsoft Direct3D 運行時間會呼叫 GetOverlayColorControls 函 式，以傳回與特定重疊相關聯的目前亮度、對比、色調、飽和度、亮度、gamma 和色彩啟用設定。
運行時間也可以針對尚未顯示的重疊呼叫 GetOverlayColorControls 。 在此情況下，當 pData 所指向之D3DDDIARG_GETOVERLAYCOLORCONTROLS結構的 hOverlay 成員設定為 NULL 時，驅動程式應該會傳回重疊硬體的預設色彩控制設定。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | d3dumddi.h (包含 D3dumddi.h) |