WcsGetDefaultColorProfileSize-Funktion (icm.h)
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 |