GetColorProfileFromHandle 함수(icm.h)
열려 있는 색 프로필에 대한 핸들이 제공되면 GetColorProfileFromHandle 함수는 프로필의 내용을 애플리케이션에서 제공하는 버퍼에 복사합니다. 핸들이 WCS(Windows Color System) 핸들인 경우 DMP가 반환되고 HPROFILE과 연결된 CAMP 및 GMMP가 무시됩니다.
구문
BOOL GetColorProfileFromHandle(
HPROFILE hProfile,
PBYTE pProfile,
PDWORD pcbProfile
);
매개 변수
hProfile
열려 있는 색 프로필에 대한 핸들입니다. 함수는 HPROFILE에 ICC 또는 WCS 프로필 정보가 포함되어 있는지 여부를 결정합니다.
pProfile
원시 ICC 또는 DMP 프로필 데이터를 수신하는 버퍼에 대한 포인터입니다. NULL일 수 있습니다. 이 경우 버퍼에 필요한 크기는 pcbSize가 가리키는 메모리 위치에 저장됩니다. 버퍼는 적절한 크기에 할당할 수 있으며, 이 함수는 버퍼의 주소를 포함하는 pBuffer 를 사용하여 다시 호출됩니다.
pcbProfile
pBuffer가 가리키는 버퍼 크기를 보유하는 DWORD에 대한 포인터입니다. 반환할 때 함수가 성공하면 실제로 사용된 버퍼 크기로 채워집니다. pBuffer가 NULL로 설정된 상태에서 이 함수를 호출하는 경우 이 매개 변수에는 필요한 버퍼의 크기가 포함됩니다.
반환 값
이 함수가 성공하면 반환 값은 TRUE입니다. pBuffer 매개 변수가 NULL이고 버퍼에 필요한 크기가 pcbSize로 복사되면 FALSE를 반환합니다.
이 함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보는 GetLastError를 호출합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | icm.h |
| 라이브러리 | Mscms.lib |
| DLL | Mscms.dll |