DrvIcmSetDeviceGammaRamp-Funktion (winddi.h)

Die Funktion DrvIcmSetDeviceGammaRamp legt die Hardware-Gammarampe des angegebenen Anzeigegeräts fest.

Syntax

BOOL DrvIcmSetDeviceGammaRamp(
  DHPDEV dhpdev,
  ULONG  iFormat,
  LPVOID lpRamp
);

Parameter

dhpdev

Handle zum PDEV des physischen Geräts. Dadurch wird das physische Gerät identifiziert, dessen Gamma-Rampe festgelegt werden soll.

iFormat

Gibt das Datenformat des Puffers an, auf den lpRamp zeigt. Dieser Parameter ist immer IGRF_RGB_256WORDS.

lpRamp

Zeiger auf den Puffer, der die Gammarampe enthält, die auf dem Gerät festgelegt werden soll. Das Format der Daten in diesem Puffer wird durch iFormat bestimmt.

Wenn iFormat IGRF_RGB_256WORDS ist, zeigt lpRamp auf eine GAMMARAMP-Struktur , die die 256-Einstiegsrampen definiert, die für jeden der roten, blauen und grünen Farbkanäle festgelegt werden sollen. Jeder Wert wird mit einer Genauigkeit von 16 Bit beschrieben. Wenn die Hardware über weniger Genauigkeitsbits verfügt, sollte sie nach unten geschaltet und die wichtigsten Bits ohne Rundung verwendet werden.

Rückgabewert

DrvIcmSetDeviceGammaRamp gibt bei Erfolg TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

Treiber für Anzeigegeräte mit ladebaren Hardware-Gammarampen sollten diese Funktion implementieren.

DrvIcmSetDeviceGammaRamp sollte fehlschlagen, wenn es mit einem anderen Wert außer IGRF_RGB_256WORDS in iFormat aufgerufen wird.

Der Treiber bindet diese Funktion ein, indem er das GCAPS2_CHANGEGAMMARAMP-Flag im FlGraphicsCaps2-Feld der devinfo-Struktur festlegt, die an DrvEnablePDEV übergeben wird. Wenn der Treiber in einem palettisierten 8bpp-Modus ausgeführt wird, ist diese Funktion optional.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	winddi.h (einschließlich Winddi.h)

Weitere Informationen

DrvEnablePDEV