函数功能：
SetPixel 函数将指定坐标处的像素设为指定的颜色。
API 函数原型：
注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选参数。
COLORREF SetPixel( _In_ HDC hdc, _In_ int x, _In_ int y, _In_ COLORREF crColor );
参数解析：
|
参数 |
含义 |
|
hdc |
设备环境句柄 |
|
x |
指定要设置的像素点的 X 轴坐标，按逻辑单位表示坐标 |
|
y |
指定要设置的像素点的 Y 轴坐标，按逻辑单位表示坐标 |
|
crColor |
1. 指定该像素点的颜色 |
注释：COLORREF 颜色被定义为 DWORD 类型（4 个字节），用于表示 RGB 颜色。
返回值：
1. 如果函数调用成功，那么返回值就是函数设置像素的 RGB 颜色值（这个值可能与 crColor 指定的颜色有所不同，之所以有时发生这种情况是因为没有找到对指定颜色进行真正匹配造成的）；
2. 如果函数调用失败，那么返回值是 -1。
可以是以下值
|
返回值 |
含义 |
|
ERROR_INVALID_PARAMETER |
一个或者多个参数不正确 |
备注：
1. 如果像素点坐标位于当前剪裁区之外，那么该函数执行失败。
2. 不是所有设备都支持 SetPixel 函数。有关详情，请参考 GetDeviceCaps。