简介DirectX SDK 是微软面向 Windows 平台游戏开发与图形编程推出的软件开发工具包适合游戏开发者、图形程序员及需要调用底层硬件能力的项目使用。它提供 Direct3D、DirectSound、DirectInput、DirectShow 等核心 API覆盖 3D 渲染、音频处理、输入设备控制与多媒体流播放是构建高性能图形与多媒体应用的重要基础。对于依赖 DirectX 技术实现图形与音频功能的项目如描述中提到的“网狐”编译场景该 SDK 可提供必要的库、头文件与编译支持。资源以 zip 压缩包形式提供包体约 18.62MB文件总数与类型明细上游暂未给出但通常包含开发所需的头文件、库文件及配套文档。目前已有 277 人学习下载适合需要搭建 DirectX 开发环境、研究经典图形接口或维护旧版 Windows 游戏项目的读者参考使用。1. DirectX SDK 不是“装完就完事”从运行库缺失到着色器编译的整条链路很多人第一次搜 DirectX SDK是因为某个游戏或工具弹了窗d3dx9_43.dll 找不到、XINPUT1_3.dll 缺失、或者 PotPlayer 提示“当前音频无法播放DirectX 驱动程序未正确安装”。这时候大多数人会去下 DirectX 修复工具增强版点一下“检测并修复”重启问题消失。但如果你是个开发者或者你手上这台机器要长期跑图形程序、音视频工具、老引擎编译链那“修复工具”只是止血不是治病。DirectX SDK 真正要解决的问题是你的程序在编译期和运行期分别依赖哪些组件这些组件从哪来版本怎么对齐装错了会以什么形式翻车。这篇笔记面向两类人一类是被 dll 缺失反复折磨的运维和测试另一类是需要在 Windows 上编译老渲染代码、跑 D3DX 工具链的图形方向开发者。我会把 DirectX SDK 的历史包袱、运行库与 SDK 的区别、安装路径、编译参数、以及最常见的几个坑按能复现的顺序讲清楚。2. DirectX SDK 到底装的是什么运行库、SDK、D3DX 三者的边界2.1 为什么“DirectX 修复工具”能修好但 SDK 装完还是报错先把一个反直觉的结论放在前面DirectX 修复工具增强版解决的是运行库缺失而 DirectX SDK 解决的是开发期头文件、库和工具链。这两件事在 Windows 上被微软拆成了两条线而且从 Windows 8 开始DirectX 的运行库已经内置进系统不再单独发布 DirectX End-User Runtime 的完整包。你看到的 d3dx9_43.dll、d3dx11_43.dll、XAudio2_7.dll 这些属于旧版 D3DX 辅助库和 XAudio 的运行期组件它们不在纯净系统里但很多老程序硬依赖。DirectX SDK 的最后一个独立版本是 2010 年 6 月版之后微软把 DirectX 的开发组件并入了 Windows SDK。所以你在网上看到的“DirectX SDK 下载”绝大多数指向的是 DXSDK_Jun10.exe。这个包里面包含头文件d3d9.h、d3d11.h、d3dx9.h、d3dx11.h、xaudio2.h 等库文件d3d9.lib、d3d11.lib、d3dx9.lib、d3dx11.lib、xinput.lib 等工具fxc.exe着色器编译器、texconv.exe、dxdiag 的旧版、PIX 的旧版运行期再分发包DXSETUP.exe用来把 d3dx9_43、d3dx11_43、xinput1_3 等装进系统关键点装完 DirectX SDK 不等于系统里就有了 d3dx9_43.dll。SDK 安装目录下确实带了一份运行期 cab 包但默认安装流程不一定把它注册进系统。这就是为什么很多人装完 SDK编译过了一运行还是提示缺 dll。2.2 运行库、SDK、D3DX 的依赖关系表组件作用谁需要典型文件来源DirectX 运行库程序运行时调用的动态库最终用户、老游戏d3dx9_43.dll、xinput1_3.dllDirectX End-User Runtime / 修复工具DirectX SDK开发期头文件、lib、工具开发者、编译机d3dx9.h、d3dx9.lib、fxc.exeDXSDK_Jun10.exeD3DX辅助数学库、纹理加载、着色器编译使用 D3DX 的老代码d3dx9.lib、d3dx11.libDirectX SDK 内Windows SDK新版 DirectX 开发组件新项目、UWPd3d12.h、dxgi.hWindows SDK 安装器这张表要记住一句话运行库给用户SDK 给编译机D3DX 是历史遗留新项目不要碰。如果你只是想让某个软件跑起来装运行库或修复工具就够了如果你要编译一份 2010 年前后的渲染代码才需要 SDK。2.3 安装 DirectX SDK 的最小步骤与路径确认我一般会在编译机上按下面顺序做避免路径和版本混在一起# 1. 下载 DXSDK_Jun10.exe 后用管理员权限运行 # 安装路径不要带空格避免老 Makefile 解析失败 # 推荐C:\DXSDK\ # 2. 安装完成后确认头文件和库文件存在 dir C:\DXSDK\Include\d3d9.h dir C:\DXSDK\Lib\x86\d3dx9.lib # 3. 把 SDK 的 Include 和 Lib 加到编译环境变量 set INCLUDEC:\DXSDK\Include;%INCLUDE% set LIBC:\DXSDK\Lib\x86;%LIB% # 4. 确认着色器编译器可用 C:\DXSDK\Utilities\bin\x86\fxc.exe /?逻辑说明第 1 步的路径不带空格是血泪经验老项目的 vcxproj 或 Makefile 里经常直接拼$(DXSDK_DIR)Lib空格会让命令行断掉。第 3 步用环境变量而不是只改 IDE 设置是因为很多老构建脚本从 shell 继承 INCLUDE 和 LIB。第 4 步验证 fxc.exe是因为 D3DX 编译着色器的代码路径依赖它如果 fxc 不在 PATH 里运行期D3DXCompileShader会失败。参数说明/x86和/x64要和你目标平台一致32 位程序链 x86 目录64 位链 x64 目录。混用会报LNK1112: module machine type x64 conflicts with target machine type x86。3. 用 fxc 编译第一个着色器从命令行到 D3DX 运行期调用3.1 fxc.exe 的命令行参数怎么设DirectX SDK 里的 fxc 是旧版着色器编译器支持 vs_2_0、ps_2_0、vs_3_0、ps_3_0 这些 profile。新项目用 dxc但老代码和 D3D9 项目仍然绕不开 fxc。最小可用命令如下# 编译一个顶点着色器输出字节码 fxc /T vs_3_0 /E main /Fo vertex.shader vertex.hlsl # 编译一个像素着色器带调试信息 fxc /T ps_3_0 /E main /Zi /Fo pixel.shader pixel.hlsl # 查看编译后的常量表排查寄存器分配 fxc /T vs_3_0 /E main /Fc vertex.asm vertex.hlsl逻辑说明/T指定目标 profileD3D9 用 vs_3_0/ps_3_0D3D10 用 vs_4_0/ps_4_0D3D11 用 vs_5_0/ps_5_0。/E指定入口函数名默认是 main但很多老代码入口叫VS_Main或PS_Main写错会报error X3501: main: entrypoint not found。/Fo输出二进制字节码/Fc输出汇编文本排查寄存器溢出时看/Fc最直接。参数说明/Zi生成调试信息配合/Od关闭优化方便 PIX 里看变量。但发布版本要去掉/Zi否则字节码变大加载变慢。/O3是最高优化老 fxc 对 ps_3_0 的优化有限别指望它能救回写得很差的循环。3.2 在 C 里用 D3DXCompileShader 动态编译很多老引擎不在构建期编译着色器而是在运行期用 D3DXCompileShader 动态编译。这样做的好处是改 shader 不用重编 exe坏处是运行期依赖 d3dx9_43.dll 和 fxc 的编译逻辑。最小调用片段// 需要链接 d3dx9.lib并包含 d3dx9.h ID3DXBuffer* code nullptr; ID3DXBuffer* errors nullptr; HRESULT hr D3DXCompileShader( shaderSource, // HLSL 源码字符串 strlen(shaderSource), // 源码长度 nullptr, // 宏定义数组没有就传 nullptr nullptr, // Include 接口没有就传 nullptr main, // 入口函数 vs_3_0, // profile 0, // 编译标志调试时用 D3DXSHADER_DEBUG code, // 输出字节码 errors, // 输出错误信息 nullptr // 常量表不需要就传 nullptr ); if (FAILED(hr)) { // errors 里是编译错误文本直接输出到日志 OutputDebugStringA((const char*)errors-GetBufferPointer()); return hr; } // code-GetBufferPointer() 传给 CreateVertexShader逻辑说明D3DXCompileShader内部会调用 fxc 的编译逻辑所以它依赖 d3dx9_43.dll。如果系统里没有这个 dll程序启动就崩根本走不到编译。errors返回的是 ID3DXBuffer里面是文本必须判空再读。code用完要 Release否则每次热重载都泄漏。参数说明第 7 个参数是编译标志常用组合是D3DXSHADER_DEBUG | D3DXSHADER_SKIPOPTIMIZATION用于调试发布时传 0。第 8 个参数常量表如果传非空可以拿到常量寄存器分配但会增加编译时间一般只在工具里用。3.3 运行期缺 d3dx9_43.dll 的两种补法如果你编译过了运行时报d3dx9_43.dll 找不到说明目标机器没有 D3DX 运行期。两种补法第一种把 DirectX SDK 安装目录下的Redist\DXSETUP.exe拷到目标机运行。这个包会安装所有旧版 D3DX 和 XAudio 运行期。注意它不会覆盖系统里更新的组件所以是安全的。第二种直接把 d3dx9_43.dll 放到 exe 同目录。但这样做有风险32 位程序要放 32 位 dll64 位放 64 位放错会报0xc000007b。我一般只在测试机上这么干正式分发还是走 DXSETUP。提示DirectX 修复工具增强版本质上就是帮你做了第一种补法外加注册表修复和 C 运行库检查。它不能替代 SDK也不能让编译通过。4. 避坑与排查DirectX SDK 安装后仍然报错的 5 个真实原因4.1 现象装完 SDK编译报 d3dx9.h 找不到原因IDE 或构建脚本没有指向 SDK 的 Include 目录。DirectX SDK 不会自动把路径写进 Visual Studio 的全局设置尤其是 VS2010 之后的版本。解决在项目属性里加C:\DXSDK\Include到附加包含目录加C:\DXSDK\Lib\x86到附加库目录。如果是 CMake用include_directories(C:/DXSDK/Include)和link_directories(C:/DXSDK/Lib/x86)。注意路径用正斜杠或双反斜杠单反斜杠在 CMake 里会被转义。4.2 现象链接报 LNK2019找不到 D3DXCompileShader原因只加了头文件路径没加 lib 路径或者没在链接器输入里写 d3dx9.lib。解决确认d3dx9.lib在附加依赖项里。如果是 x64 项目必须链C:\DXSDK\Lib\x64\d3dx9.lib链 x86 的会报模块机器类型冲突。另外D3DXCompileShader 在 d3dx9.lib 里不在 d3d9.lib 里别搞混。4.3 现象运行时报 0xc000007b或者 d3dx9_43.dll 加载失败原因32 位程序加载了 64 位 dll或者反过来。也可能是 dll 版本不对比如把 Windows 系统目录里的 d3dx9_43.dll 替换成了修改版。解决用 Dependency Walker 或dumpbin /headers确认 exe 和 dll 的机器类型一致。不要从网上随便下单个 dll 替换系统文件优先用 DXSETUP 安装。如果已经替换坏了用sfc /scannow修复系统文件再重装运行期。4.4 现象fxc.exe 编译报错 X3501 entrypoint not found原因入口函数名写错或者 HLSL 源码里入口函数被条件编译屏蔽了。解决先用/Fc输出汇编确认 fxc 能解析到入口。检查 HLSL 里#if宏是否把 main 包进去了。如果是 D3DXCompileShader检查第 5 个参数传的入口名和源码里是否一致大小写敏感。4.5 现象PotPlayer 提示“当前音频无法播放DirectX 驱动程序未正确安装”原因这个提示不一定是 DirectX SDK 的问题更多是音频输出设备被禁用或者 DirectX 音频组件XAudio2、DirectSound运行期缺失。解决先检查设备管理器里声卡是否正常再检查 PotPlayer 的音频输出设置切换 DirectSound、WASAPI、XAudio2 试。如果确认是 DirectX 运行期缺失用 DXSETUP 补装不要只装 SDK。修复工具增强版能处理一部分但它不装 SDK 的开发组件。5. 把 DirectX SDK 用对版本对齐、工具链隔离和一个验证习惯5.1 版本对齐SDK 2010 和 Windows SDK 的共存策略DirectX SDK 2010 和 Windows 8/10/11 SDK 可以共存但顺序很重要。如果你先装 Windows SDK再装 DirectX SDK后者可能会覆盖部分头文件和库导致新项目编译报错。我一般这样做编译老 D3D9/D3DX 项目时单独开一个环境INCLUDE 和 LIB 只指向C:\DXSDK\不混 Windows SDK。编译新 D3D11/D3D12 项目时用 Windows SDK 的路径不把 DXSDK 加进去。如果必须在同一台机器上切换用批处理脚本设置环境变量而不是改系统全局变量。# 老项目环境 set DXSDK_DIRC:\DXSDK\ set INCLUDE%DXSDK_DIR%Include;%INCLUDE% set LIB%DXSDK_DIR%Lib\x86;%LIB% # 新项目环境另开一个 cmd set INCLUDEC:\Program Files (x86)\Windows Kits\10\Include\10.0.19041.0\um;%INCLUDE%逻辑说明环境变量是进程级的不同 cmd 窗口互不影响。这样比在系统属性里改全局变量安全避免把新项目带崩。DXSDK_DIR这个变量很多老 vcxproj 会直接引用设好它比硬编码路径更通用。5.2 工具链隔离fxc 和 dxc 不要混用fxc 和 dxc 是两个时代的编译器。fxc 支持 vs_3_0 到 vs_5_0dxc 支持 vs_6_0 和 SM 6.x。如果你把 fxc 的输出喂给 D3D12 的 CreateVertexShader可能能跑但拿不到 SM 6 的特性。反过来dxc 编译的 DXIL 不能给 D3D9 用。我的习惯是项目里明确写死用哪个编译器构建脚本里检查版本。比如# 检查 fxc 版本确认是 DirectX SDK 里的 C:\DXSDK\Utilities\bin\x86\fxc.exe /? # 检查 dxc 版本确认是 Windows SDK 里的 C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\dxc.exe --version参数说明fxc 没有--version只能用/?看帮助。dxc 有--version输出里带 commit hash。构建脚本里可以 grep 关键字判断避免用错编译器导致 shader 模型不匹配。5.3 一个验证习惯先跑 dxdiag再跑最小 D3D 程序每次在新机器上配 DirectX 环境我会按这个顺序验证运行dxdiag看 DirectX 版本、显示设备、声音设备是否正常。编译一个最小 D3D9 程序只做Direct3DCreate9和CreateDevice不画东西。如果第 2 步失败看返回的 HRESULTD3DERR_NOTAVAILABLE 通常是驱动问题D3DERR_INVALIDCALL 是参数问题。再跑一个最小 D3DX 程序调用D3DXCompileShader编译一个空 shader确认 d3dx9_43.dll 和 fxc 逻辑可用。这个习惯帮我省了很多时间。因为 DirectX 的问题经常是分层的驱动层、运行期层、SDK 层、代码层。dxdiag 先排除驱动和运行期最小程序再排除 SDK 和代码。不要一上来就编译整个引擎那样报错信息会混在一起根本分不清是哪一层。我自己的教训是曾经在一台测试机上反复装 DirectX SDK装了三遍还是报 d3dx9_43.dll 缺失最后发现是 DXSETUP 没跑SDK 只装了开发组件。从那以后我每次装完 SDK 都会手动跑一遍C:\DXSDK\Redist\DXSETUP.exe再跑 dxdiag 确认。这个习惯看起来笨但比事后查 dll 依赖快得多。希望帮到你。本文还有配套的精品资源点击获取
