Freigeben über

GetColorProfileFromHandle-Funktion (icm.h)

  • Artikel

Mit einem Handle für ein geöffnetes Farbprofil kopiert die GetColorProfileFromHandle-Funktion den Inhalt des Profils in einen von der Anwendung bereitgestellten Puffer. Wenn es sich bei dem Handle um ein WcS-Handle (Windows Color System) handelt, wird der DMP zurückgegeben, und die dem HPROFILE zugeordneten CAMP und GMMP werden ignoriert.

Syntax

BOOL GetColorProfileFromHandle(
  HPROFILE hProfile,
  PBYTE    pProfile,
  PDWORD   pcbProfile
);

Parameter

hProfile

Handle mit einem offenen Farbprofil. Die Funktion bestimmt, ob das HPROFILE ICC- oder WCS-Profilinformationen enthält.

pProfile

Zeiger auf Puffer, um unformatierte ICC- oder DMP-Profildaten zu empfangen. Kann NULL sein. Wenn dies der Grund ist, wird die für den Puffer erforderliche Größe an der Speicherposition gespeichert, auf die von pcbSize verwiesen wird. Der Puffer kann der entsprechenden Größe zugeordnet werden, und diese Funktion wird erneut aufgerufen, wobei pBuffer die Adresse des Puffers enthält.

pcbProfile

Zeiger auf ein DWORD , das die Größe des Puffers enthält, auf den pBuffer verweist. Bei der Rückgabe wird die Größe des Puffers gefüllt, die tatsächlich verwendet wurde, wenn die Funktion erfolgreich ist. Wenn diese Funktion aufgerufen wird und pBuffer auf NULL festgelegt ist, enthält dieser Parameter die Größe des erforderlichen Puffers.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE. Es gibt FALSE zurück, wenn der pBuffer-ParameterNULL ist und die für den Puffer erforderliche Größe in pcbSize kopiert wird.

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

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

Weitere Informationen