XLATEOBJ_cGetPalette 함수(winddi.h)

XLATEOBJ_cGetPalette 함수는 지정된 색상표에서 RGB 색 또는 비트필드 형식을 검색합니다.

구문

ENGAPI ULONG XLATEOBJ_cGetPalette(
       XLATEOBJ *pxlo,
  [in] ULONG    iPal,
       ULONG    cPal,
       ULONG    *pPal
);

매개 변수

pxlo

GDI가 요청된 정보를 검색하는 XLATEOBJ 구조체에 대한 포인터입니다.

[in] iPal

작성할 팔레트 정보를 식별합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
XO_DESTBITFIELDS	GDI는 대상 팔레트의 비트 필드 형식을 검색합니다.
XO_DESTPALETTE	GDI는 대상 팔레트에서 RGB 색을 검색합니다.
XO_SRCBITFIELDS	GDI는 원본 팔레트의 비트 필드 형식을 검색합니다.
XO_SRCPALETTE	GDI는 원본 팔레트에서 RGB 색을 검색합니다.

cPal

pPal이 가리키는 버퍼의 항목 수를 지정합니다. 색상표의 총 크기보다 작을 수 있습니다.

pPal

GDI가 요청된 팔레트 정보를 작성하는 버퍼에 대한 포인터입니다. iPal이 XO_SRCPALETTE 또는 XO_DESTPALETTE 각 색상표 유형이 PAL_INDEXED 경우 각 항목은 24비트 RGB 값입니다.

iPal이 XO_SRCBITFIELDS 또는 XO_DESTBITFIELDS 각 색상표 유형이 PAL_BITFIELDS, PAL_RGB 또는 PAL_BGR 경우 pPal은 빨간색, 녹색 및 파란색 마스크를 나타내는 세 개의 ULONG 마스크를 가리킵니다.

반환 값

XLATEOBJ_cGetPalettepPal 이 null이 아닌 경우 작성된 항목 수를 반환합니다. XLATEOBJ가 null이거나 해당 색상표가 잘못된 경우 값이 0으로 반환됩니다. pxlo가 가리키는 데이터가 iPal의 값과 일치하지 않는 경우에도 XLATEOBJ_cGetPalette 0을 반환합니다. 예를 들어 가리키는 데이터가 비트 필드이지만 iPal 이 XO_SRCPALETTE 또는 XO_DESTPALETTE 설정된 경우 XLATEOBJ_cGetPalette 0을 반환합니다. 마찬가지로 pxlo 가 가리키는 데이터가 색상표이지만 iPal 이 XO_SRCBITFIELDS 또는 XO_DESTBITFIELDS 설정된 경우 XLATEOBJ_cGetPalette 0도 반환합니다.

설명

드라이버에는 색상 혼합의 몇 가지 방법을 수행하려면 색상표에 대한 정보가 있어야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	winddi.h(Winddi.h 포함)
라이브러리	Win32k.lib
DLL	Win32k.sys

추가 정보

XLATEOBJ