### 函数功能

该函数将指定坐标处的像素设置为与指定颜色最接近的颜色，该像素点必须在剪辑区和设备表面的可视部分内。

### 函数原型

BOOL SetPixeIV(HDC hdc, int X, int Y, COLORREF crColor)；

### 参数

hdc：设备环境句柄。 X：指定要设置点的X轴坐标，按逻辑单位表示坐标。 Y：指定要设置点的Y轴坐标，按逻辑单位表示坐标。 crColor：指定要用来绘制像素点的颜色。

### 返回值

如果函数成功，那么返回值非零；如果函数失败，那么返回值为零。 Windows NT：若想获得更多的错误信息，请调用GetLastError。 备注：不是所有设备都支持SetPixeIV函数0。有关这方面的更多信息，请参考GetDeviceCaps函数中有关RC_BITBLT特性的描述。SetPixeIV比SetPixel快，因为前者不需要返回实际绘制点的颜色值。

### 速查

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：wingdi.h：库文件：gdi32.lib。