CMCheckColorsInGamut-Funktion (icm.h)

Artikel
02/29/2024

[CMCheckColorsInGamut ist ab Windows Vista nicht mehr verfügbar.]

Bestimmt, ob die angegebenen RGB-Dreier im Ausgabeumfang einer angegebenen Transformation liegen.

Syntax

BOOL CMCheckColorsInGamut(
  HCMTRANSFORM hcmTransform,
  RGBTRIPLE    *lpaRGBTriple,
  LPBYTE       lpaResult,
  UINT         nCount
);

Parameter

hcmTransform

Gibt die zu verwendende Transformation an.

lpaRGBTriple

Zeigt auf ein Zu überprüfende Array von RGB-Dreifachen.

lpaResult

Zeigt auf den Puffer, in dem Ergebnisse abgelegt werden sollen.

Die Ergebnisse werden durch ein Array von Bytes dargestellt. Jedes Byte im Array entspricht einem RGB-Dreier und weist einen Wert ohne Vorzeichen zwischen 0 und 255 auf. Der Wert 0 gibt an, dass sich die Farbe im Farbraum befindet, während ein Nichtzero-Wert angibt, dass er sich außerhalb des Farbraums befindet. Für jede ganze Zahl n im Bereich 0 <n< 255 gibt ein Ergebniswert von n + 1 an, dass die entsprechende Farbe mindestens so weit außerhalb des Farbraums liegt, wie durch einen Ergebniswert von n angegeben würde.

nCount

Gibt die Anzahl der Elemente im Array an.

Rückgabewert

Ab Windows Vista gibt der Standard-CMM (Icm32.dll) FALSE zurück, und GetLastError meldet ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP und Windows 2000:

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

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um den Fehler abzurufen.

Hinweise

Ab Windows Vista sind CMM-Implementors nicht mehr erforderlich, um diese Methode zu implementieren.

Windows Server 2003, Windows XP und Windows 2000:

CMM-Implementors sind erforderlich, um diese Methode zu implementieren.

Jeder CMM ist erforderlich, um diese Funktion zu exportieren.

Wenn die Funktion nicht erfolgreich ist, sollten benutzerdefinierte CMMs SetLastError aufrufen, um den letzten Fehler auf einen gültigen Fehlerwert festzulegen, der in Winerror.h definiert ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	icm.h

Share via