在C++内核中写入像素值：调用OSDev Wiki函数的参数疑问

嘿，我之前折腾简易内核的时候也卡过这个点！正好对OSDev那篇《Drawing in Protected Mode》的内容印象深刻，来给你拆解清楚每个参数该传啥：

首先得明确前提：你得已经成功切换到VESA图形模式（因为保护模式下没法用实模式的BIOS中断操作显卡），并且从VESA的信息结构体里拿到了几个关键数据——屏幕分辨率、每像素位数（bpp）、帧缓冲物理地址、行间距（pitch）。这些是所有参数的基础。

核心参数详解 #

假设那篇文章里的像素绘制函数原型大概是这样的（不同版本略有差异，但核心参数一致）：

void put_pixel(int x, int y, uint32_t color, uint8_t* framebuffer, int pitch, int bits_per_pixel);

每个参数的作用和取值逻辑如下：

• x & y 坐标：
  像素在屏幕上的位置，原点是屏幕左上角。x的范围是0到屏幕宽度-1，y的范围是0到屏幕高度-1。比如用800x600模式时，x最大799，y最大599。超出范围会写到帧缓冲无效区域，可能导致显示错乱或内核崩溃。

• color 颜色值：
  完全取决于当前VESA模式的位深：

  • 32位色（RGB888，最常用）：直接用0xRRGGBB格式，比如纯白是0xFFFFFF，纯红是0xFF0000；
  • 16位色（RGB565）：需要把RGB值压缩到16位，比如红色是0xF800，绿色是0x07E0，蓝色是0x001F，混合色通过位运算组合（比如黄色是0xFFE0）；
  • 8位色（调色板模式）：要先设置显卡调色板，然后传对应调色板的索引值，而非直接传RGB值。

• framebuffer 帧缓冲指针：
  这是函数的核心！你需要把从VESA获取的帧缓冲物理地址，映射到内核的虚拟地址空间（如果内核启用了分页机制），再把这个虚拟地址作为指针传入。千万别直接用物理地址当指针——分页开启时，直接访问物理地址会触发页错误。

• pitch 行间距：
  帧缓冲中每一行像素占用的字节数，不一定等于屏幕宽度 * (bits_per_pixel / 8)，因为显卡会做内存对齐。这个值直接从VESA信息结构体里拿（通常叫pitch或bytes_per_scanline），必须准确传入，不然像素会画到错误位置。

• bits_per_pixel 每像素位数：
  当前VESA模式的位深，比如32、16、8，同样从VESA信息里获取，用来确定颜色值的写入方式（写4字节、2字节还是1字节）。

快速示例 #

假设你用的是800x600 32位色模式，帧缓冲虚拟地址是0xC0000000，pitch是3200（800*4），那在(100,100)位置画红色像素的调用就是：

put_pixel(100, 100, 0xFF0000, (uint8_t*)0xC0000000, 3200, 32);

常见坑提醒 #

1. 一定要确保已经正确初始化VESA模式，拿到的所有参数都是有效的；
2. 分页开启时必须做地址映射，别直接用物理地址；
3. 颜色值格式必须和位深匹配，不然会出现颜色失真；
4. 坐标别超出屏幕范围，避免越界访问。

内容的提问来源于stack exchange，提问作者oculometric