WcsGetDefaultColorProfile-Funktion (icm.h)
Ruft das Standardfarbprofil für ein Gerät ab, oder für einen geräteunabhängigen Standardwert, wenn das Gerät nicht angegeben ist.
Hinweis
Diese API unterstützt keine "erweiterten Farbprofile" für HDR-Monitore. Verwenden Sie ColorProfileGetDisplayDefault zum Verwalten erweiterter Farbprofile.
Syntax
BOOL WcsGetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
DWORD cbProfileName,
LPWSTR pProfileName
);
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 wird. Bei NULL wird ein geräteunabhängiges Standardprofil abgerufen.
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.
cbProfileName
Die Puffergröße des Puffers in Bytes, auf den pProfileName verweist.
pProfileName
Ein Zeiger auf einen Puffer, um den Namen des Farbprofils zu erhalten. Die Größe des Puffers in Bytes entspricht der von cbProfileName angegebenen Größe.
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 die Funktion WcsGetDefaultColorProfileSize , um die erforderliche Größe des Puffers abzurufen, auf den der pProfileName-Parameter verweist.
Wenn WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER vorhanden ist, wird die systemweite Standardeinstellung für profileManagementScope außer Kraft gesetzt.
Diese Funktion ist im Least-Privileged LUA-Kontext (User Account, Benutzerkonto) ausführbar.
Anforderungen
| 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 |