DrvIcmSetDeviceGammaRamp 函式 (winddi.h)
DrvIcmSetDeviceGammaRamp 函式會設定指定顯示裝置的硬體 Gamma 坡形。
語法
BOOL DrvIcmSetDeviceGammaRamp(
DHPDEV dhpdev,
ULONG iFormat,
LPVOID lpRamp
);
參數
dhpdev
實體裝置 PDEV 的句柄。 這會識別要設定其 gamma 坡形的實體裝置。
iFormat
指定 lpRamp 指向之緩衝區的數據格式。 此參數一律IGRF_RGB_256WORDS。
lpRamp
緩衝區的指標,其中包含要設定在裝置上的 gamma 坡形。 此緩衝區中的數據格式是由 iFormat決定。
當 iFormat IGRF_RGB_256WORDS時,lpRamp 會指向 GAMMARAMP 結構,該結構會定義要針對每個紅色、藍色和綠色色板設定的 256 個專案坡道。 每個值都會使用16位有效位數來描述。 如果硬體的精確度較少,它應該會向下移轉並使用最重要的位,而不進位。
傳回值
DrvIcmSetDeviceGammaRamp 會在成功時傳回 TRUE 。 否則會傳回 FALSE。
備註
用於顯示具有可載入硬體 Gamma 坡形之裝置的驅動程式應該實作此函式。
如果呼叫DrvIcmSetDeviceGammaRamp 時,除了 iFormat 中IGRF_RGB_256WORDS之外的任何其他值,它應該會失敗。
驅動程式會設定傳遞至DrvEnablePDEV之DEVINFO結構的 flGraphicsCaps2 字段中的 GCAPS2_CHANGEGAMMARAMP 旗標,以攔截此函式。 如果驅動程式是以 Palettized 8bpp 模式執行,則這項功能是選擇性的。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | winddi.h (包括 Winddi.h) |