CMCheckColors-Funktion (icm.h)

Artikel
08/24/2023

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

Freigeben über