Freigeben über

GetICMProfileA-Funktion (wingdi.h)

  • Artikel

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

Zeigen Sie auf eine DWORD-, die die Größe des Puffers enthält, auf den lpszFilenameverweist. Für die ANSI-Version dieser Funktion ist die Größe in Byte angegeben. Für die Unicode-Version befindet sich die Größe in WCHARs. Wenn diese Funktion erfolgreich ist, enthält dieser Parameter die Größe des tatsächlich verwendeten Puffers. Wenn der Puffer jedoch nicht groß genug ist, gibt diese Funktion FALSEzurück. In diesem Fall gibt die GetLastError()--Funktion ERROR_INSUFFICIENT_BUFFER zurück, und die DWORD-, auf die dieser Parameter verweist, enthält die für den lpszFilename Puffer erforderliche Größe.

pszFilename

Verweist 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 Parameter NULL- ist und die für den Puffer erforderliche Größe in lpcbName kopiert wird.

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

Bemerkungen

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

Aufgrund eines Gerätekontexts gibt GetICMProfile- über den Parameter lpszFilenameden Pfadnamen der Datei aus, die das derzeit vom Gerätekontext verwendete Farbprofil enthält. Außerdem wird der Parameter lpcbNameausgegeben, die Länge der Zeichenfolge, die den Pfadnamen enthält.

Es ist möglich, dass der von GetICMProfile zurückgegebene Profilname nicht in der Liste der von EnumICMProfileszurückgegebenen Profile enthalten ist. Die EnumICMProfiles--Funktion gibt alle Farbraumprofile zurück, die einem Gerätekontext (DC) zugeordnet sind, deren Einstellungen mit dem des DC übereinstimmen. Wenn die SetICMProfile--Funktion verwendet wird, um das aktuelle Profil festzulegen, kann ein Profil mit dem DC verknüpft werden, das nicht mit seinen Einstellungen übereinstimmt. Beispielsweise 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 EnumICMProfileszurückgegeben werden.

Wenn diese Funktion vor Aufrufen 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 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

The wingdi.h header defines GetICMProfile as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. 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