GetDIBColorTable 함수(wingdi.h)

아티클
08/27/2023

GetDIBColorTable 함수는 현재 지정된 디바이스 컨텍스트로 선택된 DIB 섹션 비트맵의 색 테이블에 있는 항목 범위에서 RGB(빨강, 녹색, 파랑) 색 값을 검색합니다.

구문

UINT GetDIBColorTable(
  [in]  HDC     hdc,
  [in]  UINT    iStart,
  [in]  UINT    cEntries,
  [out] RGBQUAD *prgbq
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다. 이 디바이스 컨텍스트에서 DIB 섹션 비트맵을 선택해야 합니다.

[in] iStart

검색할 첫 번째 색 테이블 항목을 지정하는 0부터 시작하는 색 테이블 인덱스입니다.

[in] cEntries

검색할 색 테이블 항목의 수입니다.

[out] prgbq

DIB 색 테이블의 색 정보를 포함하는 RGBQUAD 데이터 구조의 배열을 수신하는 버퍼에 대한 포인터입니다. 버퍼는 cEntries 값만큼 많은 RGBQUAD 데이터 구조를 포함할 수 있을 만큼 커야 합니다.

반환 값

함수가 성공하면 반환 값은 함수가 검색하는 색 테이블 항목의 수입니다.

함수가 실패하면 반환 값은 0입니다.

설명

GetDIBColorTable 함수를 호출하여 1, 4 또는 8 bpp를 사용하는 DIB 섹션 비트맵의 색 테이블을 검색해야 합니다. 비트맵과 연결된 BITMAPINFOHEADER 구조체의 biBitCount 멤버는 픽셀당 비트 수를 지정합니다. biBitCount 값이 8보다 큰 DIB 섹션 비트맵에는 색 테이블이 없지만 연결된 색 마스크가 있습니다. GetObject 함수를 호출하여 해당 색 마스크를 검색합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll