SetICMProfileA 함수(wingdi.h)
SetICMProfile 함수는 지정된 색 프로필을 지정된 DC(디바이스 컨텍스트)의 출력 프로필로 설정합니다.
구문
BOOL SetICMProfileA(
HDC hdc,
LPSTR lpFileName
);
매개 변수
hdc
색 프로필을 설정할 디바이스 컨텍스트를 지정합니다.
lpFileName
설정할 색 프로필의 경로 이름을 지정합니다.
반환 값
이 함수가 성공하면 반환 값은 TRUE입니다.
이 함수가 실패하면 반환 값은 FALSE입니다.
설명
SetICMProfile은 색 프로필을 디바이스 컨텍스트와 연결합니다. 해당 디바이스 컨텍스트의 출력 프로필이 됩니다. 색 프로필은 특정 디바이스와 연결할 필요가 없습니다. sRGB와 같은 디바이스 독립적 프로필도 사용할 수 있습니다. 색 프로필이 하드웨어 디바이스와 연결되지 않은 경우 GetICMProfile에서 반환되지만 EnumICMProfiles에서는 반환되지 않습니다.
Windows 95 이상에서 프린터용 PostScript 디바이스 드라이버는 CMYK 색 모델을 가정합니다. 따라서 모든 PostScript 프린터는 CMYK 색 프로필을 사용해야 합니다. Windows 2000에는 이 제한이 없습니다.
SetICMProfile 은 호환되는 DC의 RGB 프로필만 지원합니다.
Windows 95/98/Me: SetICMProfileW 는 Microsoft Layer for Unicode에서 지원됩니다. 이를 사용하려면 Windows 95/98/Me 시스템의 유니코드용 Microsoft Layer에 설명된 대로 특정 파일을 애플리케이션에 추가해야 합니다.
참고
wingdi.h 헤더는 SETICMProfile을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |