GetDIBColorTable 함수(wingdi.h)
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 |