SetDeviceGammaRamp 函式 (wingdi.h)

SetDeviceGammaRamp 函式會在直接色彩顯示器面板上設定 gamma 坡形，其驅動程式支援硬體中可下載的 Gamma 坡形。

重要

強烈建議您不要使用此 API。 使用此 API 受限於主要限制：

• SetDeviceGammaRamp 會實作啟發學習法，以檢查提供的坡道是否會導致無法讀取的畫面。 如果坡形違反這些啟發學習法，則函式會以無訊息方式 (失敗，也就是傳回 TRUE，但不會設定您的坡道) 。 基於這個理由，您無法預期使用此函式只設定 任何任意 Gamma 坡形。 特別是，啟發學習法可防止導致幾乎所有圖元接近單一值 (，例如全螢幕黑色/白色) ，因為這可能會防止用戶復原螢幕。

• 由於函式的全域本質，系統上的任何其他應用程式隨時都可以覆寫您已設定的任何坡形。 在某些情況下，操作系統本身可能會保留使用此函式，導致覆寫任何現有的坡形。 大部分的顯示事件也會重設 gamma 坡形， (連接/中斷監視、解析變更等 ) 。 因此，您無法確定您設定的任何坡道都生效。

• 此 API 在 HDR 模式中具有未定義的行為。

• 此 API 與內建和第三方色彩校正解決方案都未定義互動。

針對色彩校正，建議您建立國際色彩聯盟 (ICC) 配置檔，並讓 OS 套用配置檔。 針對進階原始設備製造商 (OEM) 案例，有一個裝置驅動程式模型，可讓您更直接用來自定義色彩校正。 如需管理色彩配置文件的資訊，請參閱 Windows 色彩系統 。

針對藍色光線篩選，Windows 現在提供稱為 「夜間燈」的內建支援。 我們建議將用戶導向此功能。

例如，針對色彩調適 (，根據環境光線感測器調整色彩校正) ，Windows 現在提供內建支援，我們建議 OEM 使用。

針對自定義篩選效果，有各種不同的內建輔助功能 色彩篩選 條件，可協助處理各種案例。

語法

BOOL SetDeviceGammaRamp(
  HDC    hdc,
  LPVOID lpRamp
);

參數

hdc

指定有問題的直接色彩顯示面板的裝置內容。

lpRamp

緩衝區的指標，其中包含要設定的 gamma 坡形。 gamma 坡形會分別以三個 256 個 WORD 元素的陣列指定，每個數位類比框架緩衝區中的 RGB 值與數位模擬轉換器之間的對應 (DAC ) 值。 陣列序列為紅色、綠色、藍色。 RGB 值必須儲存在每個 WORD 的最顯著位，以增加 DAC 獨立性。

傳回值

如果此函式成功，則傳回值為 TRUE。

如果此函式失敗，則傳回值為 FALSE。

備註

直接色彩顯示模式不使用色彩查閱表格，而且通常是16、24或32位。 並非所有直接色彩視訊板都支援可載入的 Gamma 坡形。 SetDeviceGammaRamp 僅適用於支持硬體中可下載之 gamma 坡形的裝置。

注意

此 API 可能需要一段時間才能執行。 可能需要 200 毫秒才能在某些硬體上傳回。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	wingdi.h
程式庫	Gdi32.lib
Dll	Gdi32.dll

另請參閱

• 基本色彩管理概念
• 函式