EngQueryPalette 함수(winddi.h)

EngQueryPalette 함수는 특성에 대해 지정된 팔레트를 쿼리합니다.

구문

ENGAPI ULONG EngQueryPalette(
  HPALETTE hpal,
  ULONG    *piMode,
  ULONG    cColors,
  ULONG    *pulColors
);

매개 변수

hpal

쿼리할 팔레트에 대한 핸들입니다.

piMode

원래 EngCreatePalette에 지정된 대로 색상표 모드를 수신하는 위치에 대한 포인터입니다.

cColors

pulColors가 가리키는 버퍼의 항목 수를 지정합니다. 반환 값은 cColors 가 음수인지 여부에 따라 달라집니다.

pulColors

색상표 색 정보를 수신하는 버퍼에 대한 포인터입니다. cColors가 0이면 pulColors는 NULL일 수 있습니다.

반환 값

cColors가 0이면 EngQueryPalette는 색상표 색 정보를 반환하기 위해 pulColors가 가리키는 버퍼에 필요한 팔레트 항목 수를 반환합니다. cColors가 0이 아니고 pulColors가 NULL이 아닌 경우 EngQueryPalette는 pulColors가 가리키는 버퍼에 기록된 항목 수를 반환합니다.

설명

색상표 모드가 PAL_BITFIELDS, PAL_RGB 또는 PAL_BGR, pulColors 가 가리키는 버퍼가 충분히 큰 경우 pulColors 는 색상표의 빨간색, 녹색 및 파란색 마스크를 나타내는 세 개의 ULONG 마스크를 가리킵니다.

색상표 모드가 PAL_INDEXED pulColors 가 가리키는 버퍼가 충분히 큰 경우 pulColors 는 색상표 색을 나타내는 24비트 RGB 값을 모두 포함합니다.

드라이버는 GCAPS_PALMANAGED 플래그가 있는지 테스트하여 색이 고정 색상표를 나타내는지 또는 변경 가능한 팔레트를 나타내는지 확인해야 합니다.

EngQueryPalette 는 기본 디스플레이의 색 형식을 알아야 하는 미러링 드라이버에서 사용하기 위한 것입니다. 미러링 드라이버는 일반적으로 DrvEnablePDEV 루틴에서 이 함수를 호출합니다.

요구 사항

추가 정보

DrvEnablePDEV

EngCreatePalette