DirectX修复工具使用技巧之三——命令行与配置文件参数介绍

Posted 2021-10-27 VBcom

最后更新：2021-10-8

        DirectX修复工具自V1.2版起支持通过settings.ini配置文件的方式设置程序配置信息，自V3.7版起支持命令行配置功能。由于命令行与配置文件均需要通过参数设定程序配置信息，本文档详细列出了命令行与配置文件的参数使用方式，供有需要的高级用户参考。命令行与配置文件中约有90%的命令是通用的，部分特殊命令只支持命令行的配置方式，本文件将分别介绍命令行参数与配置文件参数。

命令行参数

        本程序支持命令行参数提示，用户可通过/?或者/help命令查看具体的命令行参数。这里以本人电脑为例，演示命令行参数使用方法。在本人电脑中，DirectX修复工具主程序的位置为桌面上的DirectX_Repair(Enhanced_Edition)文件夹内，因此主程序的路径为：C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe。以下所有参数均以此路径为例，在其他电脑上相应修改路径即可。

1、查看命令行帮助

参数：/?或者/help

完整参数（如下图）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /?

         这里我们在cmd中写路径时，需要用英文状态的引号把路径扩上，这是因为路径中有空格，如果不加引号的话，cmd遇到空格将无法识别。运行此命令的效果如下：

         此界面详细介绍了各个参数的意义和用法，可供用户参考。此界面为自适应语言界面，因此如果你的电脑系统语言为英文，你将看到一个英文的提示界面，如果你的电脑语言为繁体中文，你将看到一个繁体中文的提示界面。

2、语言参数

参数：/Autolanguage，/Chinese，/tChinese，/English

参数解释：

/Autolanguage - 程序将使用自适应语言显示窗口界面，即如果系统语言为中文，则显示中文界面，否则显示英文界面。

/Chinese - 程序使用简体中文显示窗口界面，不考虑系统语言情况。

/tChinese - 程序使用繁体中文显示窗口界面，不考虑系统语言情况。

/English - 程序使用英文显示窗口界面，不考虑系统语言情况。

备注：如果不添加此类语言参数，则程序将默认使用简体中文语言。

完整参数示例1（显示繁体中文）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /tChinese

显示效果：

 完整参数示例2（显示英文）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /English

显示效果：

3、自动化修复、静默修复

参数：/passive，/timeout=XXX，/quiet

参数解释：

/passive - 程序将显示最小化界面，并自动开始修复，修复完成后10秒自动退出。此参数适合需要将本程序集成、内嵌、调用的用户使用，可实现自动化修复功能。

/timeout=XXX - 此参数可配合/passive参数使用，指定修复完成后程序自动退出的时间，取值范围为0-99，或大于100的整数。例如，使用参数/timeout=3，则意味着程序修复完成后3秒自动退出；如果使用参数/timeout=0，则程序在修复完成后立即退出；如果使用参数/timeout=100，则程序修复完成后不会自动退出，必须手动点击退出。

/quiet- 程序将不显示任何窗口或提示，进行后台静默修复，修复完成后自动退出。此参数适合需要集成、内嵌、调用本程序时不显示任何窗口的用户使用。特别注意，为防止本程序被恶意静默使用，使用此参数前需要先向作者申请授权，未授权的用户将会收到提示信息（如下示例3）。具体情况可通过E-mail联系。

备注：如果不添加此类参数，程序将显示完整界面。

完整参数示例1（最小化程序界面自动修复）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /passive

显示效果：

 修复完成后：

 完整参数示例2（最小化程序界面自动修复，修复后1秒自动退出）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /passive /timeout=1

修复完成后：

 完整参数示例3（静默修复）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /quiet

由于此参数没有界面，因此此处不提供效果截图。

如果用户尚未获得授权，使用静默模式时会看到如下提示：

4、安全级别参数

参数：/dlowsecurity，/flowsecurity

参数解释：

/dlowsecurity - 此参数只针对第一次运行本程序的电脑生效，程序的安全级别将默认设置为低。如果没有添加此参数，第一次运行本程序的电脑将默认使用高安全级别。此参数适合将本程序嵌入、调用修复时，在客户电脑指定安全级别时使用（因为客户电脑通常都是首次使用本程序，所以可以调整默认参数）。

/flowsecurity - 此次运行程序时强制使用低安全级别，不论之前如如何设定。不论之前用户设定的安全级别是高或低，如果命令行中添加此条参数，则此次程序将强制以低安全级别运行程序。此参数适合因高安全级别导致下载失败而无法修复的用户使用。

备注：如果不添加此类参数，程序不会调整安全级别。

完整参数示例1（强制低安全级别）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /flowsecurity

使用效果：

        如上图，程序将强制使用低安全级别，且此次运行时用户不能更改安全级别。 

5、强力修复参数

参数：/APIenhance，/C++enhance

参数解释：

/APIenhance - 使用此参数后，程序将启用API Sets强力修复功能。适合需要使用API Sets强力修复功能的用户使用。

/C++enhance - 使用此参数后，程序将启用C++强力修复功能。适合需要使用C++强力修复功能的用户使用。

备注：如果不添加此类参数，程序不会更改当前的强力修复设置。

完整参数示例（启用API Sets强力修复和C++强力修复）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /APIenhance /C++enhance

使用效果：

 

6、自动扩展参数

参数：/ExtendFirst

参数解释：

/ExtendFirst - 使用此参数后，程序将在启动时立即检查C++数据包状态，如果数据包缺失则先自动扩展为增强版。可与/passive等命令配合使用，实现先自动扩展再自动修复。

备注：如果不添加此参数，程序将不会自动扩展。

完整参数示例1（自动扩展）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /ExtendFirst

使用效果：

完整参数示例2（自动扩展，然后自动修复）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /ExtendFirst /passive

使用效果：

 

7、C++检测修复参数

参数：/NoDetectC++，/NoPromptC++，/NoDefaultC++，/ForceDisplayC++

参数解释：

/NoDetectC++ - 不检测修复C++，即使当前使用的是增强版程序。

/NoPromptC++ - 在使用标准版、在线修复版时，如果修复完成后检测到C++存在可能导致0xc000007b的错误也不对用户进行提示。

/NoDefaultC++ - 使用增强版程序时，主界面“检测并修复”按钮旁的“同时更新C++”下拉框不默认勾选，如用户希望修复C++需要手动勾选。

/ForceDisplayC++ - 强制显示修复C++的下拉按钮，即使C++状态正常或使用的不是增强版。

备注：如果不添加此参数，程序将使用智能检测模式，即如果当前系统C++存在异常且程序为增强版时，显示修复C++的下拉箭头，其余情况不显示。如果当前使用的是标准版或在线修复版，且修复完成后检测到C++存在可能导致0xc000007b错误的异常，则提示用户升级为增强版后再修复。

完整参数示例（强制显示修复C++按钮）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /ForceDisplayC++

8、DirectX加速控制参数

参数：/EnableDirectDraw，/DisableDirectDraw，/EnableDirect3D，/DisableDirect3D，/EnableAGP，/DisableAGP

参数解释：

/EnableDirectDraw - 快速启用DirectDraw加速，并给出提示。

/DisableDirectDraw - 快速关闭DirectDraw加速，并给出提示。

/EnableDirect3D - 快速启用Direct3D加速，并给出提示。

/DisableDirect3D - 快速关闭Direct3D加速，并给出提示。

/EnableAGP - 快速启用AGP纹理加速，并给出提示。

/DisableAGP - 快速关闭AGP纹理加速，并给出提示。

备注：此类参数可与/passive、/quiet参数组合使用实现自动化启停及提示功能。如与/passive参数组合使用，则可实现启用/关闭某项参数后，给出提示，10秒后提示自动关闭；与/quiet参数组合使用，则可实现启用/关闭某项参数，不显示任何提示。

完整参数示例1（快速启用Direct3D加速）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /EnableDirect3D

使用效果：

完整参数示例2（快速关闭Direct3D加速）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /DisableDirect3D

使用效果：

完整参数示例3（快速启用DirectDraw加速，不显示任何提示，此处的/quiet参数不需要授权）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /EnableDirectDraw /quiet

9、授权信息参数：/Copyright=XXX

参数解释：

/Copyright=XXX - 程序运行时显示授权信息，提示授权给XXX用户使用。此功能适用于学术用户，在调用本程序进行学术研究、测试、展示时，显示已授权信息，满足学术要求。

完整参数示例（显示授权给zhangyue使用）：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /copyright=zhangyue

使用效果：

 

配置文件参数

        配置文件settings.ini需要放置于与DirectX Repair.exe主程序同一目录下，如下图：

        如果您的程序目录下没有Settings.ini文件，则可以手动创建。双击Settings.ini文件即可通过记事本程序打开，默认文档如下图：

        其中每一行写一条参数，已存在的参数可以直接修改，其余参数可以自行添加。

10、语言参数

参数：Language=XXX

参数解释：XXX可替换为Auto、Chinese、tChinese、English，分别对应自动语言、简体中文、繁体中文、英语。如果配置文件中不写此条参数则程序将使用简体中文进行显示。效果截图可参见命令行参数2。

11、窗口样式参数

参数：FormStyle=XXX

参数解释：XXX可替换为Normal、Simple，分别对应正常窗口、最小化信息窗口。如果配置文件中不写此条参数则程序默认使用正常窗口模式。效果截图可参见命令行参数3。

12、安全级别参数

参数：ForceLowSecurity=True

参数解释：强制使用低安全级别，不论之前如如何设定。效果截图可参见命令行参数4。

13、加密下载参数

参数：SecureLink=True

参数解释：使用加密链接进行文件下载、扩展。

14、C++修复参数

参数：DetectC++=False、PromptC++=False、DefaultC++=False、ForceDisplayC++=True

参数解释：不检测C++、不提示C++异常、默认不勾选C++、强制显示C++下拉框。详细描述可参见命令行参数7。

15、时间参数

参数：Timeout=XXX

参数解释：XXX为数字，可替换为0-99，或大于等于100的整数。可与FormStyle=Simple参数配合使用，实现修复完成后自定义退出时间。

16、自动扩展参数

参数：ExtendFirst=True

参数解释：使用此参数后，程序将在启动时立即检查C++数据包状态，如果数据包缺失则先自动扩展为增强版。可与FormStyle=Simple等命令配合使用，实现先自动扩展再自动修复。效果截图可参见命令行参数6。

17、加速控制模式参数

参数：AccelerationMode=Old

参数解释：使用此参数后，在“工具”->“选项”->“Direct加速”界面，程序将用旧版算法进行检测。旧版检测算法速度很快，但结果可能不准确。此参数适合因系统软硬件原因而导致无法兼容新版参数的用户使用。

18、授权信息参数

参数：NeedforCopyright=XXX

参数解释：XXX可替换为要授权的人或组织，最多支持15个字符。此参数适用于学术用户，在调用本程序进行学术研究、测试、展示时，显示已授权信息，满足学术要求。效果截图可参见命令行参数9。

其他说明

1、命令行参数、配置文件参数，仅推荐明确了解其含义的高级用户使用，普通用户不建议使用这些参数。

2、命令行参数优先于配置文件参数，即如果通过命令行指定了参数，即使程序目录下有Settings.ini配置文件，程序也不会读取任何参数。

3、使用命令行参数时，如果文件路径中有空格，一定要将文件路径用英文引号括起来，否则cmd无法识别。

4、所有命令行参数、配置文件参数均不区分大小写，本文中部分字母大写只是为了显示美观。

5、所有命令行参数、配置文件参数均需使用完整拼写。例如命令行参数，如果使用了/english，程序将使用英文进行显示，但如果只写了/eng，则程序不会识别这个参数。

6、对于命令行参数，同一类参数只能同时使用一个，但不同类参数间可以组合搭配只用。例如语言参数，只能指定一个，如果同时使用了/Chinese和/English，则程序只会识别最后一个/English参数。不同参数组合，例如使用了以下参数：

"C:\\Users\\zhangyue\\Desktop\\DirectX_Repair(Enhanced_Edition)\\DirectX Repair.exe" /ExtendFirst /passive /timeout=3 /english /apienhance /c++enhance

则程序会以简约（最小化信息）窗口运行，显示语言为英语，程序启动后立即进行扩展，扩展后会自动开始修复，修复时启用C++强力修复和API Sets强力修复，并且修复完成后3秒自动退出。

7、还有一些小众化、特殊功能的命令行、配置参数未在此文中列出，如有特殊需求可咨询作者。

总结

        本文详细列明了DirectX修复工具的命令行参数和配置参数使用方法，推荐有需要的高级用户参考使用。大部门命令行参数、配置文件参数功能相同，程序根据用户需要提供了2种不同接口。对于DirectX修复工具参数的问题都可以参见此篇文档，如有其他疑问也可与作者联系。