EnumICMProfilesA-Funktion (wingdi.h)

Artikel
08/27/2023

Die EnumICMProfiles-Funktion listet die verschiedenen Ausgabefarbprofile auf, die das System für einen bestimmten Gerätekontext unterstützt.

Syntax

int EnumICMProfilesA(
  HDC          hdc,
  ICMENUMPROCA proc,
  LPARAM       param
);

Parameter

hdc

Gibt den Gerätekontext an.

proc

Gibt die Prozedur instance Adresse einer Rückruffunktion an, die von der Anwendung definiert wird. (Siehe EnumICMProfilesProcCallback.)

param

Von der Anwendung bereitgestellte Daten, die zusammen mit den Farbprofilinformationen an die Rückruffunktion übergeben werden.

Rückgabewert

Diese Funktion gibt null zurück, wenn die Anwendung die Enumeration unterbrochen hat. Der Rückgabewert ist -1, wenn keine Farbprofile aufgelistet werden müssen. Andernfalls ist der Rückgabewert der letzte Wert, der von der Rückruffunktion zurückgegeben wird.

Hinweise

Die EnumICMProfiles-Funktion gibt eine Liste von Profilen zurück, die einem Gerätekontext (DC) zugeordnet sind und deren Einstellungen mit denen des DC übereinstimmen. Es ist möglich, dass ein Gerätekontext Geräteprofile enthält, die nicht bestimmten Hardwaregeräten zugeordnet sind, oder Geräteprofile, die nicht mit den Einstellungen des Domänencontrollers übereinstimmen. Das sRGB-Profil ist ein Beispiel. Die SetICMProfile-Funktion wird verwendet, um diese Typen von Profilen einem DC zuzuordnen. Die GetICMProfile-Funktion kann verwendet werden, um ein Profil abzurufen, das nicht von der EnumICMProfiles-Funktion aufgezählt wird.

Windows 95/98/Me:EnumICMProfilesW wird von Microsoft Layer for Unicode unterstützt. Um dies zu verwenden, müssen Sie Ihrer Anwendung bestimmte Dateien hinzufügen, wie unter Microsoft Layer for Unicode unter Windows 95/98/Me Systems beschrieben.

Hinweis

Der wingdi.h-Header definiert EnumICMProfiles als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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

Freigeben über