GetDeviceGammaRamp-Funktion (wingdi.h)

Die GetDeviceGammaRamp-Funktion ruft die Gamma-Rampe auf Direktfarbanzeigeboards mit Treibern ab, die herunterladbare Gamma-Rampen in der Hardware unterstützen.

Wichtig

Es wird dringend empfohlen, diese API nicht zu verwenden. Die Verwendung dieser API unterliegt erheblichen Einschränkungen. Weitere Informationen finden Sie unter SetDeviceGammaRamp .

Syntax

BOOL GetDeviceGammaRamp(
  HDC    hdc,
  LPVOID lpRamp
);

Parameter

hdc

Gibt den Gerätekontext der betreffenden Anzeigetafel mit direkter Farbe an.

lpRamp

Zeigt auf einen Puffer, in dem die Funktion die aktuelle Gammarampe der Farbanzeigetafel platzieren kann. Die Gammarampe wird in drei Arrays mit jeweils 256 WORD-Elementen angegeben, die die Zuordnung zwischen RGB-Werten im Framepuffer und Digital-Analog-Konverter-Werten (DAC) enthalten. Die Sequenz der Arrays ist rot, grün, blau.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE.

Beispiel

WORD gArray[3][256];
GetDeviceGammaRamp(handle, gArray);  
// `handle` is the device context. See GetDC for more details.
// `gArray` will hold the gamma array values in a 2-D array

Hinweise

Direkte Farbanzeigemodi verwenden keine Farbsuchetabellen und sind in der Regel 16, 24 oder 32 Bit. Nicht alle Direktfarbvideoboards unterstützen ladebare Gamma-Rampen. GetDeviceGammaRamp ist nur für Geräte mit Treibern erfolgreich, die herunterladbare Gamma-Rampen in Hardware unterstützen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wingdi.h
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen