DrvSetPalette 함수(winddi.h)

DrvSetPalette 함수는 드라이버가 지정된 디바이스에 대한 팔레트를 실현할 것을 요청합니다.

구문

BOOL DrvSetPalette(
  DHPDEV dhpdev,
  PALOBJ *ppalo,
  FLONG  fl,
  ULONG  iStart,
  ULONG  cColors
);

dhpdev

팔레트를 실현할 디바이스를 식별하는 물리적 디바이스의 PDEV 구조에 대한 핸들입니다. 이 매개 변수는 DrvEnablePDEV에서 GDI로 반환되는 디바이스 핸들입니다.

ppalo

색(RGB 값)을 쿼리해야 하는 PALOBJ 구조체에 대한 포인터입니다.

fl

힌트 및 옵션을 제공하는 플래그 집합입니다. 이 매개 변수는 다음 값일 수 있습니다.

값	의미
SP_DEFAULT	색상표는 디바이스의 전체 기본 색상표입니다. PALOBJ는 무시할 수 있지만 올바른 내용을 포함합니다.

iStart

덮어쓸 첫 번째 색상표 인덱스를 지정합니다.

cColors

하드웨어 팔레트에서 변경할 색 수를 지정합니다. 하드웨어에서 사용할 수 있는 수를 초과하는 추가 색은 무시할 수 있습니다. cColors가 하드웨어 팔레트의 크기보다 작은 경우 cColors 항목만 설정하고 나머지 색을 그대로 둡니다.

함수가 성공하면 반환 값은 TRUE 입니다. 그렇지 않으면 FALSE이고 오류 코드가 기록됩니다.

드라이버는 지정된 팔레트의 항목과 가능한 한 가깝게 일치하도록 하드웨어 팔레트를 설정합니다.

인덱싱된 팔레트만 실현할 수 있습니다. GDIINFO 구조체의 flRasterCaps 멤버의 RC_PALETTE 비트는 디바이스에 실현 가능한 팔레트가 있는지 여부를 지정합니다.

DrvSetPalette 는 실현 가능한 팔레트를 지원하는 디스플레이 드라이버에 필요합니다.

요구 사항	값
대상 플랫폼	데스크톱
머리글	winddi.h(Winddi.h 포함)