SetDeviceGammaRamp 함수(wingdi.h)
SetDeviceGammaRamp 함수는 하드웨어에서 다운로드 가능한 감마 램프를 지원하는 드라이버가 있는 직접 색 디스플레이 보드의 감마 램프를 설정합니다.
중요
이 API를 사용하지 않는 것이 좋습니다. 이 API의 사용은 다음과 같은 주요 제한 사항이 적용됩니다.
SetDeviceGammaRamp는 추론을 구현하여 제공된 램프가 읽을 수 없는 화면으로 표시되는지 여부를 검사. 램프가 이러한 추론을 위반하는 경우 함수는 자동으로 실패합니다(즉, TRUE를 반환하지만 램프를 설정하지는 않음). 이러한 이유로 이 함수를 사용하여 임의의 감마 램프 만 설정할 것으로 예상할 수 없습니다. 특히 추론은 사용자가 화면을 복구하지 못하게 할 수 있으므로 거의 모든 픽셀이 단일 값(예: 전체 화면 흑백)에 접근하는 램프를 방지합니다.
함수의 전역 특성으로 인해 시스템의 다른 모든 애플리케이션은 언제든지 설정한 램프를 덮어쓸 수 있습니다. 경우에 따라 운영 체제 자체가 이 함수의 사용을 예약하여 기존 램프를 덮어쓸 수 있습니다. 감마 램프는 대부분의 디스플레이 이벤트(모니터 연결/연결 끊기, 해상도 변경 등)에서도 다시 설정됩니다. 따라서 설정한 램프가 적용되고 있는지 확신할 수 없습니다.
이 API에는 HDR 모드에서 정의되지 않은 동작이 있습니다.
이 API에는 기본 제공 및 타사 색 보정 솔루션과 정의되지 않은 상호 작용이 있습니다.
색 보정을 위해 ICC(International Color Consortium) 프로필을 만들고 OS에서 프로필을 적용하도록 하는 것이 좋습니다. 고급 OEM(Original Equipment Manufacturer) 시나리오의 경우 색상 보정을 보다 직접적으로 사용자 지정하는 데 사용할 수 있는 디바이스 드라이버 모델이 있습니다. 색 프로필 관리에 대한 자세한 내용은 Windows 색 시스템을 참조하세요.
청색광 필터링을 위해 Windows는 이제 야간 모드라는 기본 제공 지원을 제공합니다. 사용자를 이 기능으로 안내하는 것이 좋습니다.
색 적응(예: 주변 광원 센서에 따라 색 보정 조정)의 경우 Windows는 OEM에서 사용하는 것이 좋습니다. 기본 제공 지원을 제공합니다.
사용자 지정 필터 효과의 경우 다양한 경우에 도움이 되는 다양한 기본 제공 접근성 색 필터 가 있습니다.
구문
BOOL SetDeviceGammaRamp(
HDC hdc,
LPVOID lpRamp
);
매개 변수
hdc
문제의 직접 색 표시 보드의 디바이스 컨텍스트를 지정합니다.
lpRamp
설정할 감마 램프를 포함하는 버퍼에 대한 포인터입니다. 감마 램프는 프레임 버퍼의 RGB 값과 DAC(디지털 아날로그 변환기) 값 간의 매핑을 포함하는 각각 256개의 WORD 요소로 구성된 세 개의 배열로 지정됩니다. 배열의 시퀀스는 빨강, 녹색, 파랑입니다. DAC 독립성을 높이려면 RGB 값을 각 WORD의 가장 중요한 비트에 저장해야 합니다.
반환 값
이 함수가 성공하면 반환 값은 TRUE입니다.
이 함수가 실패하면 반환 값은 FALSE입니다.
설명
직접 색 표시 모드는 색 조회 테이블을 사용하지 않으며 일반적으로 16비트, 24비트 또는 32비트입니다. 모든 직접 색 비디오 보드가 로드 가능한 감마 램프를 지원하는 것은 아닙니다. SetDeviceGammaRamp 는 하드웨어에서 다운로드 가능한 감마 램프를 지원하는 드라이버가 있는 디바이스에 대해서만 성공합니다.
참고
이 API는 실행하는 데 사소한 시간이 걸릴 수 있습니다. 일부 하드웨어에서 반환하는 데 200ms 정도 걸릴 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |