CMCheckColors-Funktion (icm.h)
Bestimmt, ob die angegebenen Farben innerhalb des Ausgabeumfangs einer angegebenen Transformation liegen.
Syntax
BOOL CMCheckColors(
HCMTRANSFORM hcmTransform,
LPCOLOR lpaInputColors,
DWORD nColors,
COLORTYPE ctInput,
LPBYTE lpaResult
);
Parameter
hcmTransform
Handle mit der zu verwendenden Farbtransformation.
lpaInputColors
Zeiger auf ein Array von COLOR-Strukturen , um den Ausgabeumfang zu überprüfen.
nColors
Gibt die Anzahl der Elemente im Array an.
ctInput
Gibt den Eingabefarbtyp an.
lpaResult
Zeiger auf einen Puffer, in dem ein Bytearray mit den Testergebnissen platziert werden soll. Jedes Byte im Puffer entspricht einer COLOR-Struktur , und beim Beenden wurde auf einen wert ohne Vorzeichen zwischen 0 und 255 festgelegt. Der Wert 0 gibt an, dass sich die Farbe im Farbraum befindet, während ein Nichtzerowert angibt, dass sie außerhalb des Farbraums liegt. Für jede ganze Zahl n , so dass 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. Diese Werte werden normalerweise aus dem gamutTag im ICC-Profil generiert.
Rückgabewert
Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Wenn die Funktion nicht erfolgreich ist, sollte der CMM SetLastError aufrufen, um den letzten Fehler auf einen gültigen Fehlerwert festzulegen, der in Winerror.h definiert ist.
Hinweise
Jeder CMM ist erforderlich, um diese Funktion zu exportieren.
Wenn der Eingabefarbtyp nicht mit der Farbtransformation kompatibel ist, schlägt CMCheckColors fehl.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | icm.h |