Freigeben über

EnumICMProfilesA-Funktion (wingdi.h)

  • Artikel

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 Prozedurinstanzadresse einer von der Anwendung definierten Rückruffunktion an. (Siehe EnumICMProfilesProcCallback.)

param

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

Rückgabewert

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

Bemerkungen

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 DC ü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 für Unicode unterstützt. Um dies zu verwenden, müssen Sie Ihrer Anwendung bestimmte Dateien hinzufügen, wie in Microsoft Layer for Unicode unter Windows 95/98/Me Systemsbeschrieben.

Anmerkung

Der wingdi.h-Header definiert EnumICMProfiles als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung Wert
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- wingdi.h
Library Gdi32.lib
DLL- Gdi32.dll

Siehe auch