D3D11指定IDXGIAdapter调用CreateDevice返回E_INVALIDARG的原因及解决

错误原因分析 #

你遇到的E_INVALIDARG错误，通常由以下几种情况导致：

• Feature Level不兼容：你指定的Direct3D特性级别（比如D3D_FEATURE_LEVEL_11_0）超出了目标Adapter的支持范围。传NULL时系统会自动选择兼容的Adapter和最低要求的Feature Level，因此能执行成功。
• Adapter实例无效：枚举到的IDXGIAdapter被提前释放，或者枚举过程中硬件设备被移除（少见场景），导致传入的指针失效。
• 参数组合错误：指定Adapter时，D3D_DRIVER_TYPE未设为D3D_DRIVER_TYPE_UNKNOWN；或是启用了调试层，但Adapter驱动不支持调试组件。

正确使用IDXGIAdapter创建设备的步骤 #

1. 正确枚举IDXGIAdapter #

通过CreateDXGIFactory枚举系统内所有Adapter，获取有效实例：

IDXGIFactory* pFactory = nullptr;
HRESULT hr = CreateDXGIFactory(__uuidof(IDXGIFactory), (void**)&pFactory);
if (SUCCEEDED(hr))
{
    IDXGIAdapter* pAdapter = nullptr;
    UINT adapterIndex = 0;
    // 循环枚举所有可用Adapter
    while (pFactory->EnumAdapters(adapterIndex, &pAdapter) != DXGI_ERROR_NOT_FOUND)
    {
        DXGI_ADAPTER_DESC adapterDesc;
        pAdapter->GetDesc(&adapterDesc);
        // 打印Adapter信息，确认目标设备
        wprintf(L"Adapter %u: %ls\n", adapterIndex, adapterDesc.Description);

        // 用当前Adapter尝试创建设备（见步骤2）
        CreateDeviceWithAdapter(pAdapter);

        pAdapter->Release();
        adapterIndex++;
    }
    pFactory->Release();
}

2. 验证Adapter支持的Feature Level #

创建设备前，从高到低尝试Feature Level，确保Adapter兼容：

void CreateDeviceWithAdapter(IDXGIAdapter* pAdapter)
{
    // 按从高到低顺序定义待尝试的Feature Level
    D3D_FEATURE_LEVEL featureLevels[] = {
        D3D_FEATURE_LEVEL_11_1,
        D3D_FEATURE_LEVEL_11_0,
        D3D_FEATURE_LEVEL_10_1,
        D3D_FEATURE_LEVEL_10_0,
        D3D_FEATURE_LEVEL_9_3,
        D3D_FEATURE_LEVEL_9_2,
        D3D_FEATURE_LEVEL_9_1
    };
    UINT numLevels = ARRAYSIZE(featureLevels);
    D3D_FEATURE_LEVEL supportedLevel;

    ID3D11Device* pDevice = nullptr;
    ID3D11DeviceContext* pContext = nullptr;

    HRESULT hr = D3D11CreateDevice(
        pAdapter,                  // 枚举到的目标Adapter
        D3D_DRIVER_TYPE_UNKNOWN,   // 指定Adapter时必须设为UNKNOWN
        nullptr,                   // 软件驱动无需指定
        0,                         // 创建标志，调试可加D3D11_CREATE_DEVICE_DEBUG
        featureLevels,
        numLevels,
        D3D11_SDK_VERSION,         // 固定传入D3D11_SDK_VERSION
        &pDevice,
        &supportedLevel,
        &pContext
    );

    if (SUCCEEDED(hr))
    {
        wprintf(L"创建设备成功，支持的Feature Level: %u\n", supportedLevel);
        // 后续使用设备和上下文
        pContext->Release();
        pDevice->Release();
    }
    else if (hr == E_INVALIDARG)
    {
        wprintf(L"当前Adapter不支持指定的Feature Level\n");
    }
}

3. 关键参数注意事项 #

• 传入IDXGIAdapter时，D3D_DRIVER_TYPE必须设为D3D_DRIVER_TYPE_UNKNOWN，否则会直接返回E_INVALIDARG。
• 若启用调试标志D3D11_CREATE_DEVICE_DEBUG，需确保已安装Windows SDK调试组件，且目标Adapter驱动支持调试功能。
• 枚举到的Adapter使用完毕后及时调用Release()，但创建设备前不要提前释放。

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