【开源】最强截图之WGC

shanyukun

谢谢分享！

斗战胜猴

z573277679 发表于 2026-7-6 15:30
这不是Bug，而是WGC引擎的底层机制决定的。仔细看我的源码，里面定义了 集_缓存_截图数据，当底层获取不 ...

好的增加 旧针判断，沿用缓存，或者重新构造

  

子程序名	返回值类型	公开	备 注
WGC_截取图像	字节集		【作者：白枫 (精易ID:*)】
参数名	类 型	参考	可空	数组	备 注
参_目标句柄	整数型
参_左	整数型
参_顶	整数型
参_宽	整数型
参_高	整数型

变量名	类 型	静态	数组	备 注
局_最新帧	整数型
局_临时帧	整数型
局_表面对象	整数型
局_接口访问	整数型
局_D3D纹理	整数型
局_函数_获取帧	整数型
局_函数_通用	整数型
局_目标行距	整数型
局_像素指针	整数型
局_源行距	整数型
局_需创建中转	逻辑型
局_最终宽	整数型
局_最终高	整数型
局_初始化宽	整数型
局_初始化高	整数型
局_描述指针	整数型
局_映射指针	整数型
i	整数型

如果真 (集_WGC_已初始化 ＝ 假)
返回 ({  })

如果真 (集_状态_正在截图)
如果真 (取字节集长度 (集_缓存_截图数据) ＞ 0)
返回 (集_缓存_截图数据)
返回 ({  })
集_状态_正在截图 ＝ 真
如果 (参_左 ＞ 0 或 参_顶 ＞ 0)
局_初始化宽 ＝ 0
局_初始化高 ＝ 0
局_初始化宽 ＝ 参_宽
局_初始化高 ＝ 参_高

如果真 (集_WGC_会话 ＝ 0 或 集_当前_句柄 ≠ 参_目标句柄 或 集_当前_宽 ≠ 局_初始化宽 或 集_当前_高 ≠ 局_初始化高)
如果真 (WGC_重建单例对象 (参_目标句柄, 局_初始化宽, 局_初始化高) ＝ 假)
集_状态_正在截图 ＝ 假
返回 ({  })


局_函数_获取帧 ＝ Asm_取虚表函数 (集_WGC_帧池, 7)
如果真 (集_最新帧 ＝ 0)
局_临时帧 ＝ 0
判断循环首 (局_临时帧 ＝ 0)
Asm_Call2P (局_函数_获取帧, 集_WGC_帧池, Asm_取整数指针 (局_临时帧))
Asm_微秒延时 (500)
判断循环尾 ()
集_最新帧 ＝ 局_临时帧

Asm_Call2P (局_函数_获取帧, 集_WGC_帧池, Asm_取整数指针 (局_最新帧))
如果 (局_最新帧 ≠ 0)
Asm_COM释放对象 (集_最新帧)
集_最新帧 ＝ 局_最新帧


沿用旧针 ＝ 沿用旧针 ＋ 1
如果真 (集_缓存_截图数据 ≠ {  })
集_状态_正在截图 ＝ 假
返回 (集_缓存_截图数据)

局_最新帧 ＝ 集_最新帧

. ' 计次循环首 (5, )
' 局_临时帧 ＝ 0
' Asm_Call2P (局_函数_获取帧, 集_WGC_帧池, Asm_取整数指针 (局_临时帧))
. ' 如果真 (局_临时帧 ＝ 0)
' 跳出循环 ()
' Asm_COM释放对象 (局_临时帧)
. ' 计次循环尾 ()
' Asm_微秒延时 (5000)
' 局_最新帧 ＝ 0
. ' 判断循环首 (局_最新帧 ＝ 0)
' Asm_Call2P (局_函数_获取帧, 集_WGC_帧池, Asm_取整数指针 (局_最新帧))
' Asm_微秒延时 (500)
. ' 判断循环尾 ()
如果真 (局_最新帧 ≠ 0)
局_表面对象 ＝ 0
局_函数_通用 ＝ Asm_取虚表函数 (局_最新帧, 6)
Asm_Call2P (局_函数_通用, 局_最新帧, Asm_取整数指针 (局_表面对象))
如果真 (局_表面对象 ≠ 0)
局_接口访问 ＝ 0
Asm_调用_QueryInterface (局_表面对象, Asm_取字节集指针 (集_GUID_接口访问), Asm_取整数指针 (局_接口访问))
如果真 (局_接口访问 ≠ 0)
局_D3D纹理 ＝ 0
COM_调用 (局_接口访问, 3, Asm_取字节集指针 (集_GUID_D3D11纹理), Asm_取整数指针 (局_D3D纹理))
Asm_COM释放对象 (局_接口访问)
如果真 (局_D3D纹理 ≠ 0)
局_描述指针 ＝ Asm_取字节集指针 (集_缓存_纹理描述)
COM_调用 (局_D3D纹理, 10, 局_描述指针)
局_需创建中转 ＝ 集_WGC_中转纹理 ＝ 0
如果真 (局_需创建中转 ＝ 假)
如果真 (Asm_读内存整数 (局_描述指针) ≠ 集_WGC_尺寸数组 [1] 或 Asm_读内存整数 (局_描述指针 ＋ 4) ≠ 集_WGC_尺寸数组 [2])
Asm_COM释放对象 (集_WGC_中转纹理)
局_需创建中转 ＝ 真


如果真 (局_需创建中转)
集_WGC_尺寸数组 [1] ＝ Asm_读内存整数 (局_描述指针)
集_WGC_尺寸数组 [2] ＝ Asm_读内存整数 (局_描述指针 ＋ 4)
Asm_写内存整数 (局_描述指针 ＋ 28, 3)
Asm_写内存整数 (局_描述指针 ＋ 32, 0)
Asm_写内存整数 (局_描述指针 ＋ 36, 131072)
Asm_写内存整数 (局_描述指针 ＋ 40, 0)
Asm_写内存整数 (局_描述指针 ＋ 8, 1)
COM_调用 (集_D3D_设备指针, 5, 局_描述指针, 0, Asm_取整数指针 (集_WGC_中转纹理))

如果真 (集_WGC_中转纹理 ≠ 0)
COM_调用 (集_D3D_上下文指针, 47, 集_WGC_中转纹理, 局_D3D纹理)
局_映射指针 ＝ Asm_取字节集指针 (集_缓存_映射数据)
如果真 (COM_调用 (集_D3D_上下文指针, 14, 集_WGC_中转纹理, 0, 1, 0, 局_映射指针) ＝ 0)
局_像素指针 ＝ Asm_读内存整数 (局_映射指针)
局_源行距 ＝ Asm_读内存整数 (局_映射指针 ＋ 4)
局_最终宽 ＝ 参_宽
局_最终高 ＝ 参_高
如果真 (局_最终宽 ＝ 0)
局_最终宽 ＝ 集_WGC_尺寸数组 [1] － 参_左
如果真 (局_最终高 ＝ 0)
局_最终高 ＝ 集_WGC_尺寸数组 [2] － 参_顶

如果真 (参_左 ＞ 0 或 参_顶 ＞ 0)
局_像素指针 ＝ 局_像素指针 ＋ 参_顶 × 局_源行距 ＋ 参_左 × 4

局_目标行距 ＝ 局_最终宽 × 3
如果真 (局_目标行距 ％ 4 ≠ 0)
局_目标行距 ＝ 局_目标行距 ＋ 4 － 局_目标行距 ％ 4

如果真 (取字节集长度 (集_缓存_截图数据) ≠ 54 ＋ 局_目标行距 × 局_最终高)
集_缓存_截图数据 ＝ 取空白字节集 (54 ＋ 局_目标行距 × 局_最终高)

Asm_写入BMP头_24位 (Asm_取字节集指针 (集_缓存_截图数据), 局_最终宽, 局_最终高, 局_目标行距 × 局_最终高)
Asm_32位转24位_翻转 (局_像素指针, Asm_取字节集指针 (集_缓存_截图数据) ＋ 54, 局_最终宽, 局_最终高, 局_源行距, 局_目标行距)
COM_调用 (集_D3D_上下文指针, 15, 集_WGC_中转纹理, 0)


Asm_COM释放对象 (局_D3D纹理)

Asm_COM释放对象 (局_表面对象)

如果真 (局_最新帧 ≠ 0)
' Asm_COM释放对象 (局_最新帧)

集_状态_正在截图 ＝ 假
如果真 (取字节集长度 (集_缓存_截图数据) ＞ 0)
返回 (集_缓存_截图数据)
返回 ({  })

.版本 2<br /> <br /> .子程序 WGC_截取图像, 字节集, 公开, 【作者：白枫 (精易ID:*)】<br /> .参数 参_目标句柄, 整数型<br /> .参数 参_左, 整数型<br /> .参数 参_顶, 整数型<br /> .参数 参_宽, 整数型<br /> .参数 参_高, 整数型<br /> .局部变量 局_最新帧, 整数型<br /> .局部变量 局_临时帧, 整数型<br /> .局部变量 局_表面对象, 整数型<br /> .局部变量 局_接口访问, 整数型<br /> .局部变量 局_D3D纹理, 整数型<br /> .局部变量 局_函数_获取帧, 整数型<br /> .局部变量 局_函数_通用, 整数型<br /> .局部变量 局_目标行距, 整数型<br /> .局部变量 局_像素指针, 整数型<br /> .局部变量 局_源行距, 整数型<br /> .局部变量 局_需创建中转, 逻辑型<br /> .局部变量 局_最终宽, 整数型<br /> .局部变量 局_最终高, 整数型<br /> .局部变量 局_初始化宽, 整数型<br /> .局部变量 局_初始化高, 整数型<br /> .局部变量 局_描述指针, 整数型<br /> .局部变量 局_映射指针, 整数型<br /> .局部变量 i, 整数型<br /> <br /> .如果真 (集_WGC_已初始化 ＝ 假)<br />     返回 ({  })<br /> .如果真结束<br /> <br /> .如果真 (集_状态_正在截图)<br />     .如果真 (取字节集长度 (集_缓存_截图数据) ＞ 0)<br />         返回 (集_缓存_截图数据)<br />     .如果真结束<br />     返回 ({  })<br /> .如果真结束<br /> 集_状态_正在截图 ＝ 真<br /> <br /> .如果 (参_左 ＞ 0 或 参_顶 ＞ 0)<br />     局_初始化宽 ＝ 0<br />     局_初始化高 ＝ 0<br /> .否则<br />     局_初始化宽 ＝ 参_宽<br />     局_初始化高 ＝ 参_高<br /> .如果结束<br /> <br /> .如果真 (集_WGC_会话 ＝ 0 或 集_当前_句柄 ≠ 参_目标句柄 或 集_当前_宽 ≠ 局_初始化宽 或 集_当前_高 ≠ 局_初始化高)<br />     .如果真 (WGC_重建单例对象 (参_目标句柄, 局_初始化宽, 局_初始化高) ＝ 假)<br />         集_状态_正在截图 ＝ 假<br />         返回 ({  })<br />     .如果真结束<br /> <br /> .如果真结束<br /> <br /> 局_函数_获取帧 ＝ Asm_取虚表函数 (集_WGC_帧池, 7)<br /> <br /> <br /> .如果真 (集_最新帧 ＝ 0)<br />     局_临时帧 ＝ 0<br />     .判断循环首 (局_临时帧 ＝ 0)<br />         Asm_Call2P (局_函数_获取帧, 集_WGC_帧池, Asm_取整数指针 (局_临时帧))<br />         Asm_微秒延时 (500)<br />     .判断循环尾 ()<br />     集_最新帧 ＝ 局_临时帧<br /> .如果真结束<br /> <br /> <br /> Asm_Call2P (局_函数_获取帧, 集_WGC_帧池, Asm_取整数指针 (局_最新帧))<br /> .如果 (局_最新帧 ≠ 0)<br /> <br />     Asm_COM释放对象 (集_最新帧)<br />     集_最新帧 ＝ 局_最新帧<br /> .否则<br /> <br />     沿用旧针 ＝ 沿用旧针 ＋ 1<br />     .如果真 (集_缓存_截图数据 ≠ {  })<br />         集_状态_正在截图 ＝ 假<br />         返回 (集_缓存_截图数据)<br />     .如果真结束<br /> <br />     局_最新帧 ＝ 集_最新帧<br /> .如果结束<br /> <br /> .' 计次循环首 (5, )<br />     ' 局_临时帧 ＝ 0<br />     ' Asm_Call2P (局_函数_获取帧, 集_WGC_帧池, Asm_取整数指针 (局_临时帧))<br />     .' 如果真 (局_临时帧 ＝ 0)<br />         ' 跳出循环 ()<br />     .如果真结束<br />     ' Asm_COM释放对象 (局_临时帧)<br /> .' 计次循环尾 ()<br /> <br /> ' Asm_微秒延时 (5000)<br /> ' 局_最新帧 ＝ 0<br /> .' 判断循环首 (局_最新帧 ＝ 0)<br />     ' Asm_Call2P (局_函数_获取帧, 集_WGC_帧池, Asm_取整数指针 (局_最新帧))<br />     ' Asm_微秒延时 (500)<br /> .' 判断循环尾 ()<br /> <br /> .如果真 (局_最新帧 ≠ 0)<br />     局_表面对象 ＝ 0<br />     局_函数_通用 ＝ Asm_取虚表函数 (局_最新帧, 6)<br />     Asm_Call2P (局_函数_通用, 局_最新帧, Asm_取整数指针 (局_表面对象))<br /> <br />     .如果真 (局_表面对象 ≠ 0)<br />         局_接口访问 ＝ 0<br />         Asm_调用_QueryInterface (局_表面对象, Asm_取字节集指针 (集_GUID_接口访问), Asm_取整数指针 (局_接口访问))<br /> <br />         .如果真 (局_接口访问 ≠ 0)<br />             局_D3D纹理 ＝ 0<br />             COM_调用 (局_接口访问, 3, Asm_取字节集指针 (集_GUID_D3D11纹理), Asm_取整数指针 (局_D3D纹理))<br />             Asm_COM释放对象 (局_接口访问)<br /> <br />             .如果真 (局_D3D纹理 ≠ 0)<br />                 局_描述指针 ＝ Asm_取字节集指针 (集_缓存_纹理描述)<br />                 COM_调用 (局_D3D纹理, 10, 局_描述指针)<br /> <br />                 局_需创建中转 ＝ 集_WGC_中转纹理 ＝ 0<br />                 .如果真 (局_需创建中转 ＝ 假)<br />                     .如果真 (Asm_读内存整数 (局_描述指针) ≠ 集_WGC_尺寸数组 [1] 或 Asm_读内存整数 (局_描述指针 ＋ 4) ≠ 集_WGC_尺寸数组 [2])<br />                         Asm_COM释放对象 (集_WGC_中转纹理)<br />                         局_需创建中转 ＝ 真<br />                     .如果真结束<br /> <br />                 .如果真结束<br /> <br />                 .如果真 (局_需创建中转)<br />                     集_WGC_尺寸数组 [1] ＝ Asm_读内存整数 (局_描述指针)<br />                     集_WGC_尺寸数组 [2] ＝ Asm_读内存整数 (局_描述指针 ＋ 4)<br />                     Asm_写内存整数 (局_描述指针 ＋ 28, 3)<br />                     Asm_写内存整数 (局_描述指针 ＋ 32, 0)<br />                     Asm_写内存整数 (局_描述指针 ＋ 36, 131072)<br />                     Asm_写内存整数 (局_描述指针 ＋ 40, 0)<br />                     Asm_写内存整数 (局_描述指针 ＋ 8, 1)<br />                     COM_调用 (集_D3D_设备指针, 5, 局_描述指针, 0, Asm_取整数指针 (集_WGC_中转纹理))<br />                 .如果真结束<br /> <br />                 .如果真 (集_WGC_中转纹理 ≠ 0)<br />                     COM_调用 (集_D3D_上下文指针, 47, 集_WGC_中转纹理, 局_D3D纹理)<br /> <br />                     局_映射指针 ＝ Asm_取字节集指针 (集_缓存_映射数据)<br />                     .如果真 (COM_调用 (集_D3D_上下文指针, 14, 集_WGC_中转纹理, 0, 1, 0, 局_映射指针) ＝ 0)<br />                         局_像素指针 ＝ Asm_读内存整数 (局_映射指针)<br />                         局_源行距 ＝ Asm_读内存整数 (局_映射指针 ＋ 4)<br /> <br />                         局_最终宽 ＝ 参_宽<br />                         局_最终高 ＝ 参_高<br />                         .如果真 (局_最终宽 ＝ 0)<br />                             局_最终宽 ＝ 集_WGC_尺寸数组 [1] － 参_左<br />                         .如果真结束<br />                         .如果真 (局_最终高 ＝ 0)<br />                             局_最终高 ＝ 集_WGC_尺寸数组 [2] － 参_顶<br />                         .如果真结束<br /> <br />                         .如果真 (参_左 ＞ 0 或 参_顶 ＞ 0)<br />                             局_像素指针 ＝ 局_像素指针 ＋ 参_顶 × 局_源行距 ＋ 参_左 × 4<br />                         .如果真结束<br /> <br />                         局_目标行距 ＝ 局_最终宽 × 3<br />                         .如果真 (局_目标行距 ％ 4 ≠ 0)<br />                             局_目标行距 ＝ 局_目标行距 ＋ 4 － 局_目标行距 ％ 4<br />                         .如果真结束<br /> <br />                         .如果真 (取字节集长度 (集_缓存_截图数据) ≠ 54 ＋ 局_目标行距 × 局_最终高)<br />                             集_缓存_截图数据 ＝ 取空白字节集 (54 ＋ 局_目标行距 × 局_最终高)<br />                         .如果真结束<br /> <br />                         Asm_写入BMP头_24位 (Asm_取字节集指针 (集_缓存_截图数据), 局_最终宽, 局_最终高, 局_目标行距 × 局_最终高)<br />                         Asm_32位转24位_翻转 (局_像素指针, Asm_取字节集指针 (集_缓存_截图数据) ＋ 54, 局_最终宽, 局_最终高, 局_源行距, 局_目标行距)<br /> <br />                         COM_调用 (集_D3D_上下文指针, 15, 集_WGC_中转纹理, 0)<br />                     .如果真结束<br /> <br />                 .如果真结束<br /> <br />             .如果真结束<br />             Asm_COM释放对象 (局_D3D纹理)<br />         .如果真结束<br /> <br />     .如果真结束<br />     Asm_COM释放对象 (局_表面对象)<br /> <br /> .如果真结束<br /> <br /> .如果真 (局_最新帧 ≠ 0)<br />     ' Asm_COM释放对象 (局_最新帧)<br /> <br /> .如果真结束<br /> <br /> 集_状态_正在截图 ＝ 假<br /> .如果真 (取字节集长度 (集_缓存_截图数据) ＞ 0)<br />     返回 (集_缓存_截图数据)<br /> .如果真结束<br /> 返回 ({  })

z573277679

kmskik 发表于 2026-7-6 15:03
截屏为什么会有黄色的方框在窗口边缘

这个黄框是Windows操作系统（DWM）在底层强制加上去的。
这是微软在推出WGC技术时，特意引入的一项系统级隐私与安全机制。因为WGC的截屏能力太强（能无视遮挡、无视部分防截图），为了防止恶意木马或流氓软件在后台偷偷录屏、窃取用户隐私，微软强制要求在被捕获的窗口外围渲染一圈高亮的黄框，用来警示当前电脑用户：“这个窗口正在被截图/录制”。

为什么我不把它去掉？
当然这个黄框是能够去掉的。原因很简单，保留微软原生的安全行为。

alanwoo

感谢分享

温暖的舌骨

z573277679

斗战胜猴 发表于 2026-7-6 14:53
有个小bug，最新针时有时无。 不知道和dx11的区别在哪，都是拿底层的bgra颜色数据。再拼接bmp文件头，不知 ...

这不是Bug，而是WGC引擎的底层机制决定的。仔细看我的源码，里面定义了 集_缓存_截图数据，当底层获取不到新帧时，可以直接复用上一帧的缓存数据返回。这是微软官方推荐的做法。为什么这么设计？这里举两个例子。
获取太快：如果你的截图循环跑到了1000次/秒，但你的显示器是60Hz（每秒只刷新60次），那么多出来的940 次调用，系统根本没有生成新画面，TryGetNextFrame 就会直接返回 NULL。
画面静止： 如果目标窗口画面没有任何像素变动，DWM出于省电优化，可能不会投递新的帧。

另外DXGI显示器级别的捕获，不支持遮挡。
而WGC是复合管理器级别的捕获。它可以绑定某一个指定的窗口句柄，支持被遮挡的窗口。对硬件加速的窗口兼容性是目前微软官方API中最好的，不会黑屏。

chenghome

感谢分享，学习先

haifutw

感谢楼主分享优质内容，希望继续努力！

hbtudou

感觉很强大

qck易语言

        感谢分享，很给力！~