IDirectDrawGammaControl::SetGammaRamp 方法 (ddraw.h)
設定主要表面的紅色、綠色和藍色 Gamma 坡形。
語法
HRESULT SetGammaRamp(
[in] DWORD unnamedParam1,
[in] LPDDGAMMARAMP unnamedParam2
);
參數
[in] unnamedParam1
指出是否需要 Gamma 校正的旗標。 將此參數設定為DDSGR_CALIBRATE,要求校正器根據顯示器的實體屬性調整 Gamma 坡形,使結果在所有電腦上都相同。 如果不需要校正,請將此參數設定為 0。
[in] unnamedParam2
DDGAMMARAMP 結構的指標,其中包含新的紅色、綠色和藍色 Gamma 坡形專案。 每個數位都會將畫面緩衝區中的色彩值對應至要傳遞至數位對模擬轉換器的色彩值, (DAC) 。
傳回值
如果方法成功,傳回值會DD_OK。
如果失敗,方法可以傳回下列其中一個錯誤值:
- DDERR_EXCEPTION
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
備註
並非所有系統都支援 gamma 校正。 若要判斷是否支援 gamma 校正,請在 方法傳回之後呼叫 IDirectDraw7::GetCaps 並檢查相關聯 DDCAPS 結構的 dwCaps2 成員。 如果DDCAPS2_CANCALIBRATEGAMMA功能旗標存在,則會支援 gamma 校正。
校正 Gamma 坡形會產生一些處理額外負荷,不應該經常使用。
在不支援 gamma 校正的電腦上執行時,在 dwFlags 參數中包含 DDSGR_CALIBRATE 旗標,並不會導致此方法失敗。 方法會成功並設定新的 Gamma 坡形值,而不需校正。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | ddraw.h |
程式庫 | Ddraw.lib |
Dll | Ddraw.dll |