DirectX多线程共享资源句柄时DXGI_ERROR_DEVICE_REMOVED错误排查

先给你吃个定心丸：共享资源完全可以被多个线程/设备多次打开，所以你的怀疑方向不对，得从同步、资源管理这些核心点找问题。结合D3D11共享资源的实践经验，我整理了几个最可能的原因和解决思路：

1. 先搞懂DXGI_ERROR_DEVICE_REMOVED的本质 #

这个错误看起来是“设备移除”，但排除物理显示器问题后，90%的情况是GPU执行了非法操作导致驱动崩溃/重置，比如资源访问冲突、同步失效、资源状态错误这些代码层面的问题，硬件故障的概率极低。

2. 同步逻辑是重灾区（最可能的根因） #

你用了IDXGIKeyedMutex，但很多人会在这踩坑：

• 每个打开共享资源的线程，必须获取自己的IDXGIKeyedMutex实例——不能多个线程共用同一个互斥体接口，否则会出现同步混乱
• 所有对共享纹理的操作（包括CPU读取的映射/复制），必须严格包裹在AcquireSync和ReleaseSync之间。哪怕是只读操作，也得确保没有其他线程在同时写，或者GPU在执行相关指令
• 注意AcquireSync的超时设置：如果设为无限等待，一旦某个线程异常没释放锁，其他线程会卡死；建议设个合理值（比如100ms），超时后做重试或跳过处理，避免拖垮整个程序

3. OpenSharedResource1的正确姿势 #

• 每个线程打开共享资源后，必须记得Release接口：如果重复打开却不释放，会导致资源句柄泄漏，积累到一定程度就会触发设备错误
• 用DuplicateHandle复制句柄是没问题的，但要确保每个线程复制的句柄用完后调用CloseHandle，句柄泄漏也是常见的隐性问题
• 如果线程用的是独立的D3D设备，要确保这些设备是同一个GPU创建的，跨GPU共享资源需要额外的DXGI共享步骤，很容易出问题

4. 给你一套线程读取共享纹理的标准流程 #

把正确的步骤贴出来，你可以对照自己的代码检查：

// 线程内的操作流程
HRESULT ReadSharedTexture(HANDLE shareHandle, ID3D11Device* pLocalDevice, ID3D11DeviceContext* pLocalContext, void* pCpuBuffer, UINT textureWidth, UINT textureHeight)
{
    ID3D11Texture2D* pSharedTex = nullptr;
    HRESULT hr = pLocalDevice->OpenSharedResource1(shareHandle, IID_PPV_ARGS(&pSharedTex));
    if (FAILED(hr)) {
        // 这里如果出现设备错误，先记录日志再处理
        return hr;
    }

    IDXGIKeyedMutex* pKeyedMutex = nullptr;
    hr = pSharedTex->QueryInterface(IID_PPV_ARGS(&pKeyedMutex));
    if (FAILED(hr)) {
        pSharedTex->Release();
        return hr;
    }

    // 获取锁，超时100ms，避免死锁
    hr = pKeyedMutex->AcquireSync(0, 100);
    if (hr == DXGI_ERROR_WAIT_TIMEOUT) {
        // 超时处理：可以重试一次，或者直接跳过当前帧
        pKeyedMutex->Release();
        pSharedTex->Release();
        return hr;
    }
    if (FAILED(hr)) {
        // 这里如果是DXGI_ERROR_DEVICE_REMOVED，要做设备重置逻辑
        pKeyedMutex->Release();
        pSharedTex->Release();
        return hr;
    }

    // 注意：不能直接Map共享纹理（除非它是staging类型），必须先复制到CPU可见的staging纹理
    ID3D11Texture2D* pStagingTex = nullptr;
    D3D11_TEXTURE2D_DESC stagingDesc = {};
    stagingDesc.Width = textureWidth;
    stagingDesc.Height = textureHeight;
    stagingDesc.MipLevels = 1;
    stagingDesc.ArraySize = 1;
    stagingDesc.Format = DXGI_FORMAT_R8G8B8A8_UNORM; // 替换成你的纹理格式
    stagingDesc.SampleDesc.Count = 1;
    stagingDesc.Usage = D3D11_USAGE_STAGING;
    stagingDesc.CPUAccessFlags = D3D11_CPU_ACCESS_READ;
    stagingDesc.BindFlags = 0;
    stagingDesc.MiscFlags = 0;

    hr = pLocalDevice->CreateTexture2D(&stagingDesc, nullptr, &pStagingTex);
    if (SUCCEEDED(hr)) {
        pLocalContext->CopyResource(pStagingTex, pSharedTex);

        D3D11_MAPPED_SUBRESOURCE mappedRes = {};
        hr = pLocalContext->Map(pStagingTex, 0, D3D11_MAP_READ, 0, &mappedRes);
        if (SUCCEEDED(hr)) {
            memcpy(pCpuBuffer, mappedRes.pData, mappedRes.RowPitch * textureHeight);
            pLocalContext->Unmap(pStagingTex, 0);
        }
        pStagingTex->Release();
    }

    // 必须释放锁，否则其他线程拿不到
    pKeyedMutex->ReleaseSync(0);

    // 清理资源，不能漏
    pKeyedMutex->Release();
    pSharedTex->Release();

    return hr;
}

5. 最后的排查技巧 #

• 打开D3D11的调试层：创建设备时加上D3D11_CREATE_DEVICE_DEBUG标志，调试输出里会有详细的设备丢失原因，比如是哪个资源操作触发了GPU错误，这比瞎猜管用多了
• 更新GPU驱动：旧驱动经常有共享资源的bug，尤其是AMD/NVIDIA的老版本，更到最新稳定版能解决不少隐性问题
• 检查资源状态：确保共享纹理在被读取时的状态是D3D11_RESOURCE_STATE_COPY_SOURCE，如果之前有写入操作，要做状态转换

按照这个思路排查，应该能定位到问题所在。

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