GetColorProfileElement-Funktion (icm.h)
Kopiert Daten aus einem angegebenen markierten Profilelement eines angegebenen Farbprofils in einen Puffer.
Syntax
BOOL GetColorProfileElement(
HPROFILE hProfile,
TAGTYPE tag,
DWORD dwOffset,
PDWORD pcbElement,
PVOID pElement,
PBOOL pbReference
);
Parameter
hProfile
Gibt einen Handle für das betreffende ICC-Farbprofil (International Color Consortium) an.
tag
Gibt das markierte Element an, aus dem kopiert werden soll.
dwOffset
Gibt den Offset vom ersten Byte der markierten Elementdaten an, bei denen mit dem Kopieren begonnen werden soll.
pcbElement
Zeiger auf eine Variable, die die Anzahl der zu kopierenden Bytes angibt. Bei der Rückgabe enthält die Variable die Anzahl der tatsächlich kopierten Bytes.
pElement
Zeiger auf einen Puffer, in den die markierten Elementdaten kopiert werden sollen. Der Puffer muss mindestens so viele Bytes enthalten, wie von der Variablen angegeben werden, auf die von pcbSize verwiesen wird. Wenn der pBuffer-Zeiger auf NULL festgelegt ist, wird die Größe der gesamten markierten Elementdaten in Bytes in der Speicheradresse zurückgegeben, auf die von pcbSize verwiesen wird, und dwOffset wird ignoriert. In diesem Fall gibt die Funktion FALSE zurück.
pbReference
Zeigt auf einen booleschen Wert, der auf TRUE festgelegt ist, wenn mehr als ein Tag im Farbprofil auf dieselben Daten verweist, auf die sich das angegebene Tag bezieht, oder auf FALSE , falls nicht.
Rückgabewert
Wenn diese Funktion erfolgreich ist, ist der Rückgabewert nonzero.
Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.
Hinweise
Diese Funktion schlägt fehl, wenn hProfile kein gültiges ICC-Profil (International Color Consortium) ist.
Wenn der pBuffer-Zeiger auf NULL festgelegt ist, wird die Größe der gesamten markierten Elementdaten in Bytes in der Variablen zurückgegeben, auf die von pcbSize verwiesen wird, und dwOffset wird ignoriert.
Diese Funktion unterstützt keine WCS-Profile (Windows Color System) CAMP, DMP und GMMP. da Profilelemente implizit mit ICC-Tagtypen verknüpft und hart codiert sind und viele stabile XML-Analysebibliotheken vorhanden sind.
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 |