C#捕获隐藏窗口指定区域截图返回全黑位图解决方案

捕获得到纯黑位图且效率不达预期，核心是三个问题：

• PrintWindow调用时传入的nFlags参数为0，仅触发窗口的普通GDI绘制，对使用D3D硬件加速渲染、处于隐藏/最小化状态的窗口无效，窗口不会返回实际渲染内容，最终生成纯黑图像。
• 现有逻辑先创建全窗口尺寸的位图接收完整窗口内容，再二次裁剪区域，本质还是做了全窗口捕获，完全没有降低渲染、内存拷贝的开销，达不到减少特征匹配前置耗时的目的。
• 原有裁剪逻辑冗余，GDI资源释放顺序存在句柄泄漏风险。

首先调整PrintWindow参数，使用PW_RENDERFULLCONTENT（值为0x2，Win8.1及以上系统支持）标志强制窗口渲染全部内容（包括硬件加速层）；同时取消全窗口位图的创建，直接生成目标区域尺寸的位图，通过调整DC视口偏移直接捕获指定区域，省去全窗口渲染和二次拷贝的开销。

修正后的完整代码如下：

using System;
using System.Drawing;
using System.Runtime.InteropServices;

public class WindowCapture
{
    private class User32
    {
        [StructLayout(LayoutKind.Sequential)]
        public struct RECT
        {
            public int left;
            public int top;
            public int right;
            public int bottom;
        }

        [DllImport("user32.dll")]
        public static extern IntPtr GetWindowDC(IntPtr hWnd);
        [DllImport("user32.dll")]
        public static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);
        [DllImport("user32.dll")]
        public static extern bool GetWindowRect(IntPtr hWnd, ref RECT rect);
        [DllImport("user32.dll")]
        public static extern bool PrintWindow(IntPtr hWnd, IntPtr hDC, uint nFlags);
        [DllImport("gdi32.dll")]
        public static extern bool SetViewportOrgEx(IntPtr hdc, int X, int Y, out IntPtr lpPoint);
    }
    
    private class GDI32
    {
        public const int SRCCOPY = 0x00CC0020;
        public const uint PW_RENDERFULLCONTENT = 0x00000002;

        [DllImport("gdi32.dll")]
        public static extern bool BitBlt(IntPtr hObject, int nXDest, int nYDest,
            int nWidth, int nHeight, IntPtr hObjectSource,
            int nXSrc, int nYSrc, uint dwRop);
        [DllImport("gdi32.dll")]
        public static extern IntPtr CreateCompatibleBitmap(IntPtr hDC, int nWidth,
            int nHeight);
        [DllImport("gdi32.dll")]
        public static extern IntPtr CreateCompatibleDC(IntPtr hDC);
        [DllImport("gdi32.dll")]
        public static extern bool DeleteDC(IntPtr hDC);
        [DllImport("gdi32.dll")]
        public static extern bool DeleteObject(IntPtr hObject);
        [DllImport("gdi32.dll")]
        public static extern IntPtr SelectObject(IntPtr hDC, IntPtr hObject);
    }

    public Image CaptureWindowRegion(IntPtr hWnd, int x, int y, int w, int h)
    {
        IntPtr hdcSrc = IntPtr.Zero;
        IntPtr hdcDest = IntPtr.Zero;
        IntPtr hBitmap = IntPtr.Zero;
        IntPtr hOldBitmap = IntPtr.Zero;

        try
        {
            hdcSrc = User32.GetWindowDC(hWnd);
            if (hdcSrc == IntPtr.Zero) return null;

            // 边界校验，避免截取区域超出窗口范围
            User32.RECT windowRect = new User32.RECT();
            User32.GetWindowRect(hWnd, ref windowRect);
            int winW = windowRect.right - windowRect.left;
            int winH = windowRect.bottom - windowRect.top;
            x = Math.Max(0, Math.Min(x, winW - 1));
            y = Math.Max(0, Math.Min(y, winH - 1));
            w = Math.Min(w, winW - x);
            h = Math.Min(h, winH - y);

            // 直接创建目标尺寸的兼容DC和位图，不生成全窗口画布
            hdcDest = GDI32.CreateCompatibleDC(hdcSrc);
            hBitmap = GDI32.CreateCompatibleBitmap(hdcSrc, w, h);
            hOldBitmap = GDI32.SelectObject(hdcDest, hBitmap);

            // 调整视口原点，让窗口的(x,y)坐标对齐目标DC的(0,0)点，PrintWindow绘制时自动裁剪超出区域
            User32.SetViewportOrgEx(hdcDest, -x, -y, out _);
            // 传入PW_RENDERFULLCONTENT标志强制渲染完整内容，包括硬件加速层
            User32.PrintWindow(hWnd, hdcDest, GDI32.PW_RENDERFULLCONTENT);

            return Image.FromHbitmap(hBitmap);
        }
        finally
        {
            // 按顺序释放GDI资源，避免句柄泄漏
            if (hOldBitmap != IntPtr.Zero) GDI32.SelectObject(hdcDest, hOldBitmap);
            if (hBitmap != IntPtr.Zero) GDI32.DeleteObject(hBitmap);
            if (hdcDest != IntPtr.Zero) GDI32.DeleteDC(hdcDest);
            if (hdcSrc != IntPtr.Zero) User32.ReleaseDC(hWnd, hdcSrc);
        }
    }
}

• 若运行环境为Win7及以下系统，PW_RENDERFULLCONTENT标志不被支持，可将PrintWindow的nFlags参数改为0x1（仅捕获客户区），但对硬件加速窗口的捕获兼容性会下降。
• 如果使用上述代码仍然捕获到纯黑图像，说明目标窗口使用了硬件Overlay、DirectComposition独立渲染或者DRM版权保护，这种情况GDI捕获方案天然不支持，需要替换为Win10 1903及以上版本提供的Windows Graphics Capture API实现，该API对隐藏窗口、高DPI窗口、硬件加速窗口的兼容性最好，性能也远高于GDI方案。
• 该实现没有全窗口渲染和二次拷贝步骤，捕获耗时和内存占用仅和你指定的截取区域大小相关，相比全窗口截图再裁剪的方案，能大幅降低后续图像识别的前置等待时间。

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