GetICMProfileA-Funktion (wingdi.h)

Artikel
03/04/2024

Die GetICMProfile-Funktion ruft den Dateinamen des aktuellen Ausgabefarbprofils für einen angegebenen Gerätekontext ab.

Syntax

BOOL GetICMProfileA(
  HDC     hdc,
  LPDWORD pBufSize,
  LPSTR   pszFilename
);

Parameter

hdc

Gibt einen Gerätekontext an, aus dem das Farbprofil abgerufen werden soll.

pBufSize

Zeiger auf ein DWORD , das die Größe des Puffers enthält, auf den lpszFilename verweist. Für die ANSI-Version dieser Funktion ist die Größe in Bytes. Für die Unicode-Version ist die Größe in WCHARs. Wenn diese Funktion erfolgreich ist, enthält dieser Parameter bei der Rückgabe die Größe des tatsächlich verwendeten Puffers. Wenn der Puffer jedoch nicht groß genug ist, gibt diese Funktion FALSE zurück. In diesem Fall gibt die GetLastError() -Funktion ERROR_INSUFFICIENT_BUFFER zurück, und das DWORD , auf das dieser Parameter verweist, enthält die größe, die für den lpszFilename-Puffer erforderlich ist.

pszFilename

Zeigt auf den Puffer, der den Pfadnamen des Profils empfängt.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE. Außerdem wird TRUE zurückgegeben, wenn der lpszFilename-ParameterNULL ist und die für den Puffer erforderliche Größe in lpcbName kopiert wird.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE.

Hinweise

GetICMProfile ruft den Dateinamen des aktuellen Ausgabeprofils ab, unabhängig davon, ob die Farbverwaltung für den Gerätekontext aktiviert ist.

Bei einem Gerätekontext gibt GetICMProfile über den Parameter lpszFilename den Pfadnamen der Datei aus, die das Farbprofil enthält, das derzeit vom Gerätekontext verwendet wird. Außerdem wird über den Parameter lpcbName die Länge der Zeichenfolge ausgegeben, die den Pfadnamen enthält.

Es ist möglich, dass der von GetICMProfile zurückgegebene Profilname nicht in der Liste der von EnumICMProfiles zurückgegebenen Profile enthalten ist. Die EnumICMProfiles-Funktion gibt alle Farbraumprofile zurück, die einem Gerätekontext (DC) zugeordnet sind, dessen Einstellungen mit denen des DC übereinstimmen. Wenn die SetICMProfile-Funktion zum Festlegen des aktuellen Profils verwendet wird, kann dem DC ein Profil zugeordnet werden, das seinen Einstellungen nicht entspricht. Für instance kann die SetICMProfile-Funktion verwendet werden, um das geräteunabhängige sRGB-Profil einem DC zuzuordnen. Dieses Profil wird als aktuelles WCS-Profil für diesen DC verwendet, und Aufrufe von GetICMProfile geben den Dateinamen zurück. Das Profil wird jedoch nicht in der Liste der Profile angezeigt, die von EnumICMProfiles zurückgegeben werden.

Wenn diese Funktion vor einem Aufruf der SetICMProfile-Funktion aufgerufen wird, kann sie verwendet werden, um das Standardprofil für einen Gerätekontext abzurufen.

Windows 95/98/Me: GetICMProfileW 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 GetICMProfile 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

Anforderung	Wert
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