CMCheckColorsInGamut-Funktion (icm.h)
[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 |