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 |