NVAPI/AGS需在DX设备创建前初始化并绑定同源GPU设备才生效。关键点：驱动版本匹配、适配器VendorId校验（0x10DE/0x1002）、禁用WARP/Reference设备、热重载后必须重新初始化，否则调用静默失败。
DirectX 中怎么让 NVAPI 或 AGS 生效，而不是被驱动忽略
调用 NVAPI 或 AGS 接口本身不难，难的是它们必须在 DirectX 设备创建的特定上下文中才真正起作用。比如你想启用 NVIDIA 的 NvAPI_D3D_SetCurrentSLIState，但调用后毫无反应——大概率是设备没对齐。
关键点：NVAPI/AGS 不是独立渲染层，而是对已有 ID3D11Device 或 ID3D12Device 的“增强注解”。必须确保：
- 你传给
NvAPI_Initialize()或agsInitialize()的句柄，和实际渲染用的设备句柄来自同一驱动实例（不能跨进程、不能是 WARP 或 Reference 设备） - DXGI 适配器必须是对应厂商的物理 GPU（
adapterDesc.VendorId == 0x10DE才调 NVAPI，== 0x1002才调 AGS） - 初始化必须在创建任何 D3D 设备前完成；AGS 尤其严格，
agsInitialize()失败后不能 fallback 到其他路径再试
NVAPI 调用失败常见错误信息和定位方法
最常卡在 NvAPI_GetInterface() 返回 NVAPI_INVALID_ARGUMENT 或 NVAPI_NVIDIA_DEVICE_NOT_FOUND。这不是你代码写错了，而是环境链断了。
排查顺序：
立即学习“C++免费学习笔记（深入）”；
- 确认已加载
nvidia-api.dll（不是nvcuda.dll），且版本匹配当前驱动（NvAPI_QueryInterface需要驱动内核模块支持） - 检查
IDXGIFactory::EnumAdapters()枚举出的IDXGIAdapter是否真实对应 NVIDIA GPU——有些笔记本双显卡会把核显排在前面 -
NvAPI_D3D_GetCurrentSLIState这类函数要求设备创建时启用了 SLI（即D3D11_CREATE_DEVICE_FLAG含D3D11_CREATE_DEVICE_SINGLETHREADED不影响，但必须非 WARP） - 调试时用
NvAPI_ShortString打印驱动版本，低于 R465 的旧驱动不支持部分 DX12 相关接口
AGS 在 D3D12 下启用 AMD FidelityFX 等功能的实际步骤
AGS 本身不提供图像算法，它只是帮你安全地把参数喂给驱动。比如想开 FidelityFX Super Resolution (FSR)，AGS 只负责检测硬件支持、返回推荐的 AGSContext 配置，具体着色器和 UAV 绑定还得你自己做。
典型流程：
- 调用
agsInitialize()前，先用dxgiFactory->EnumAdapters(0, &adapter)拿到 AMD 显卡，再用adapter->QueryInterface(__uuidof(IDXGIAdapter3), ...)确认支持 DXGI 1.3+ - 创建 D3D12 设备后，传入
ID3D12Device*给agsDriverExtensionsDX12_CreateDevice()，不是传IDXGIAdapter - AGS 不管理资源生命周期——
agsDriverExtensionsDX12_GetGraphicsCapabilities()返回的maxAsyncComputeQueueCount是提示，不是自动分配队列 - 注意：AGS 2.4+ 才支持 D3D12 Raytracing acceleration 结构体填充，旧版调用会静默失败
为什么 NVAPI/AGS 初始化成功但功能无效
最隐蔽的问题是「上下文隔离」：Windows 10/11 的图形堆栈里，一个进程可能同时存在多个 DXGI 工厂、多个设备、甚至多个 GPU 适配器句柄。NVAPI 和 AGS 内部缓存的是首次初始化时绑定的设备指针，后续换设备不重初始化就等于对空气调用。
容易被忽略的细节：
- 游戏热重载 D3D 设备（如切换分辨率或全屏模式）后，必须重新调用
NvAPI_D3D_DestroyAllDevices()+NvAPI_Initialize()，否则旧设备句柄残留 - AGS 的
agsDriverExtensionsDX12_DestroyDevice()必须配对调用，否则下次CreateDevice()可能复用损坏状态 - 多 GPU 场景下，
NvAPI_SYS_GetPhysicalGpuFromDisplayId()返回的 GPU 不一定和你渲染用的ID3D11Device关联——得用NvAPI_D3D_GetAssociatedNvidiaGPU()反查
厂商 API 的边界比文档写的更窄：它们不是通用扩展，而是驱动与应用之间的一条私有信道。一旦设备、适配器、驱动版本、甚至 Windows 累积更新不匹配，通道就自动关闭，且通常不报错。
