WcsGetDefaultColorProfileSize-Funktion (icm.h)

Artikel
02/29/2024

Gibt die Größe des Standardfarbprofilnamens (einschließlich des NULL-Abschlussators ) für ein Gerät in Bytes zurück.

Hinweis

Diese API unterstützt keine "erweiterten Farbprofile" für HDR-Monitore. Verwenden Sie ColorProfileGetDisplayDefault zum Verwalten erweiterter Farbprofile.

Syntax

BOOL WcsGetDefaultColorProfileSize(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  PDWORD                       pcbProfileName
);

Parameter

scope

Ein WCS_PROFILE_MANAGEMENT_SCOPE Wert, der den Bereich dieses Profilverwaltungsvorgangs angibt.

pDeviceName

Ein Zeiger auf den Namen des Geräts, für das das Standardfarbprofil abgerufen werden soll. Bei NULL wird ein geräteunabhängiges Standardprofil verwendet.

cptColorProfileType

Ein COLORPROFILETYPE-Wert , der den Farbprofiltyp angibt.

cpstColorProfileSubType

Ein COLORPROFILESUBTYPE-Wert , der den Untertyp des Farbprofils angibt.

dwProfileID

Die ID des Farbraums, den das Farbprofil darstellt.

pcbProfileName

Ein Zeiger auf eine Position, die die Größe des Pfadnamens des Standardfarbprofils in Bytes empfängt, einschließlich des NULL-Abschlussators .

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Verwenden Sie diese Funktion, um die erforderliche Größe des Puffers zurückzugeben, auf die der pProfileName-Parameter in der Funktion WcsGetDefaultColorProfile verweist.

Diese Funktion ist im Least-Privileged LUA-Kontext (User Account, Benutzerkonto) ausführbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	icm.h
Bibliothek	Mscms.lib
DLL	Mscms.dll

Freigeben über