GetColorProfileElement 함수(icm.h)
지정된 색 프로필의 지정된 태그가 지정된 프로필 요소에서 버퍼로 데이터를 복사합니다.
구문
BOOL GetColorProfileElement(
HPROFILE hProfile,
TAGTYPE tag,
DWORD dwOffset,
PDWORD pcbElement,
PVOID pElement,
PBOOL pbReference
);
매개 변수
hProfile
문제의 ICC(International Color Consortium) 색 프로필에 대한 핸들을 지정합니다.
tag
복사할 태그가 지정된 요소를 식별합니다.
dwOffset
복사를 시작할 태그가 지정된 요소 데이터의 첫 번째 바이트에서 오프셋을 지정합니다.
pcbElement
복사할 바이트 수를 지정하는 변수에 대한 포인터입니다. 반환 시 변수에는 실제로 복사된 바이트 수가 포함됩니다.
pElement
태그가 지정된 요소 데이터를 복사할 버퍼에 대한 포인터입니다. 버퍼는 pcbSize가 가리키는 변수에 지정된 바이트 이상을 포함해야 합니다. pBuffer 포인터가 NULL로 설정된 경우 태그가 지정된 전체 요소 데이터의 크기(바이트)가 pcbSize가 가리키는 메모리 위치에 반환되고 dwOffset은 무시됩니다. 이 경우 함수는 FALSE를 반환합니다.
pbReference
색 프로필에서 둘 이상의 태그가 지정된 태그가 참조하는 것과 동일한 데이터를 참조하는 경우 TRUE 로 설정된 부울 값을 가리키고, 그렇지 않으면 FALSE 를 가리킵니다.
반환 값
이 함수가 성공하면 반환 값은 0이 아닌 값입니다.
이 함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보는 GetLastError를 호출합니다.
설명
hProfile이 유효한 ICC(International Color Consortium) 프로필이 아닌 경우 이 함수는 실패합니다.
pBuffer 포인터가 NULL로 설정된 경우 태그가 지정된 전체 요소 데이터의 크기(바이트)가 pcbSize가 가리키는 변수에 반환되고 dwOffset은 무시됩니다.
이 함수는 WCS(Windows Color System) 프로필 CAMP, DMP 및 GMMP를 지원하지 않습니다. 프로필 요소는 ICC 태그 형식과 암시적으로 연결되고 하드 코딩되므로 강력한 XML 구문 분석 라이브러리가 많이 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | icm.h |
| 라이브러리 | Mscms.lib |
| DLL | Mscms.dll |