DrvIcmCheckBitmapBits 함수(winddi.h)

DrvIcmCheckBitmapBits 함수는 지정된 비트맵의 픽셀이 지정된 변환의 디바이스 영역 내에 있는지 여부를 확인합니다.

구문

BOOL DrvIcmCheckBitmapBits(
  DHPDEV  dhpdev,
  HANDLE  hColorTransform,
  SURFOBJ *pso,
  PBYTE   paResults
);

dhpdev

물리적 디바이스의 PDEV에 대한 핸들입니다.

hColorTransform

비트맵을 검사할 색 변환에 대한 핸들입니다. 이 변환은 드라이버가 DrvIcmCreateColorTransform 루틴에 대한 이전 호출을 통해 만들었습니다.

pso

확인할 비트맵 표면이 포함된 SURFOBJ 에 대한 포인터입니다.

paResults

드라이버가 테스트 결과를 반환하는 바이트 배열에 대한 포인터입니다. GDI는 비트맵에 픽셀이 있는 만큼 바이트를 포함하도록 이 버퍼를 할당합니다. 드라이버는 배열에 쓰기 전에 할당 또는 바인딩된 검사를 수행할 필요가 없습니다.

DrvIcmCheckBitmapBits는 성공하면 TRUE 를 반환합니다. 그렇지 않으면 오류를 보고하고 FALSE를 반환합니다.

paResults 포인트가 비트맵의 픽셀에 해당하는 배열의 각 바이트입니다. 각 픽셀에 대해 드라이버는 해당 색 값이 디바이스 영역인지 여부를 확인한 다음 해당 배열 바이트에서 0에서 255 사이의 값을 씁니다. 값에는 다음과 같은 의미가 있습니다.

값	의미
0	색상은 디바이스 영역입니다.
0이 아닌 값	색이 영역 외부에 있습니다. n+1 값은 색이 적어도 영역 밖으로 n 값으로 있음을 나타냅니다.

DrvIcmCheckBitmapBits는 ICM을 지원하는 드라이버에서 선택적으로 구현할 수 있습니다. 드라이버는 DEVINFO 구조체의 flGraphicsCaps 멤버에서 GCAPS_ICM 플래그를 설정하여 ICM에 대한 지원을 나타냅니다.

요구 사항	값
대상 플랫폼	데스크톱
머리글	winddi.h(Winddi.h 포함)