Desktop Duplication API与D3D11中AcquireNextFrame失效，截图输出全零求助

这种输出全零的情况确实挺让人头疼——明明初始化没报错，逻辑看起来和示例也一致，但就是拿不到有效桌面像素数据。结合我之前踩过的坑，给你几个重点排查方向：

1. 确认桌面帧的获取流程是否完整 #

初始化成功只是第一步，你需要确保正确获取到新的桌面帧，很多时候问题出在这一步：

• 调用IDXGIOutputDuplication::AcquireNextFrame时，有没有设置合理的超时时间（比如1000ms）？如果超时返回DXGI_ERROR_WAIT_TIMEOUT，说明当前没有新帧，需要循环等待，而不是直接跳过。
• 获取到IDXGIResource后，有没有正确转换成ID3D11Texture2D？这里一定要检查QueryInterface的返回值，别忽略转换失败的情况。
• 处理完帧后，有没有调用ReleaseFrame释放资源？如果没释放，后续的AcquireNextFrame可能会一直失败。

示例代码片段参考：

IDXGIResource* pDesktopResource = nullptr;
DXGI_OUTDUPL_FRAME_INFO frameInfo;
HRESULT hr = pOutputDuplication->AcquireNextFrame(1000, &frameInfo, &pDesktopResource);

if (FAILED(hr)) {
    if (hr == DXGI_ERROR_WAIT_TIMEOUT) {
        // 无新帧，继续等待
        return false;
    }
    // 其他错误可能需要重新初始化桌面复制
    return false;
}

ID3D11Texture2D* pDesktopTexture = nullptr;
hr = pDesktopResource->QueryInterface(__uuidof(ID3D11Texture2D), reinterpret_cast<void**>(&pDesktopTexture));
pDesktopResource->Release();

if (FAILED(hr)) {
    // 纹理转换失败，处理错误
    return false;
}

2. 检查纹理映射的细节 #

映射纹理时的参数或逻辑错误，也会导致读取到全零数据：

• 映射时使用的MapFlags是不是D3D11_MAP_READ？别误用了写权限的标志。
• 映射后一定要检查D3D11_MAPPED_SUBRESOURCE::pData是否非空，同时确认RowPitch（行字节数）是否符合纹理的宽度和格式（比如DXGI_FORMAT_B8G8R8A8_UNORM格式下，行字节数应该是宽度×4，还要考虑内存对齐）。
• 确认映射的是0级子资源（Map的第二个参数是0），桌面复制的纹理都是单级别单数组的。

比如映射后的像素检查：

D3D11_MAPPED_SUBRESOURCE mappedResource;
hr = pDeviceContext->Map(pDesktopTexture, 0, D3D11_MAP_READ, 0, &mappedResource);

if (SUCCEEDED(hr)) {
    BYTE* pPixels = static_cast<BYTE*>(mappedResource.pData);
    // 检查第一个像素的B/G/R/A通道值
    if (pPixels[0] == 0 && pPixels[1] == 0 && pPixels[2] == 0 && pPixels[3] == 0) {
        // 这里可以加日志，确认是全零还是映射有问题
    }
    pDeviceContext->Unmap(pDesktopTexture, 0);
}
pDesktopTexture->Release();
pOutputDuplication->ReleaseFrame();

3. 启用D3D调试模式，抓隐藏错误 #

很多时候DXGI的问题不会直接返回失败码，但会在调试输出里给出警告。你可以修改D3D11CreateDevice的参数，启用调试设备：

CHECKHR(D3D11CreateDevice(nullptr, D3D_DRIVER_TYPE_HARDWARE, nullptr, 
    D3D11_CREATE_DEVICE_DEBUG, // 加上这个标志
    gFeatureLevels, gNumFeatureLevels, D3D11_SDK_VERSION, &pDevice, &featureLevel, &pDeviceContext));

然后打开Visual Studio的“输出”窗口，运行程序时查看有没有DXGI或D3D的错误提示——比如纹理格式不兼容、资源状态错误等，这些都是排查问题的关键线索。

4. 确认Desktop Duplication的创建流程正确 #

再回头检查初始化时创建IDXGIOutputDuplication的步骤：

• 有没有从IDXGIAdapter正确枚举输出，并转换成IDXGIOutput1？
• 调用DuplicateOutput时，传入的D3D设备是不是和适配器匹配？
• 如果你的系统有多显示器，是不是枚举了正确的输出（比如索引0是主显示器）？

内容的提问来源于stack exchange，提问作者M. Alvarez