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

时间:2024-11-06 07:48:02

最后更新:2021-10-8

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

命令行参数

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

1、查看命令行帮助

参数:/?或者/help

完整参数(如下图):

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

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

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

2、语言参数

参数:/Autolanguage,/Chinese,/tChinese,/English

参数解释:

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

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

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

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

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

完整参数示例1(显示繁体中文):

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

显示效果:

 完整参数示例2(显示英文):

"C:\Users\zhangyue\Desktop\DirectX_Repair(Enhanced_Edition)\DirectX " /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 " /passive

显示效果:

 修复完成后:

 完整参数示例2(最小化程序界面自动修复,修复后1秒自动退出):

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

修复完成后:

 完整参数示例3(静默修复):

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

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

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

4、安全级别参数

参数:/dlowsecurity,/flowsecurity

参数解释:

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

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

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

完整参数示例1(强制低安全级别):

"C:\Users\zhangyue\Desktop\DirectX_Repair(Enhanced_Edition)\DirectX " /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 " /APIenhance /C++enhance

使用效果:

 

6、自动扩展参数

参数:/ExtendFirst

参数解释:

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

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

完整参数示例1(自动扩展):

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

使用效果:

完整参数示例2(自动扩展,然后自动修复):

"C:\Users\zhangyue\Desktop\DirectX_Repair(Enhanced_Edition)\DirectX " /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 " /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 " /EnableDirect3D

使用效果:

完整参数示例2(快速关闭Direct3D加速):

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

使用效果:

完整参数示例3(快速启用DirectDraw加速,不显示任何提示,此处的/quiet参数不需要授权):

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

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

参数解释:

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

完整参数示例(显示授权给zhangyue使用):

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

使用效果:

 

配置文件参数

        配置文件需要放置于与DirectX 主程序同一目录下,如下图:

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

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

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、命令行参数优先于配置文件参数,即如果通过命令行指定了参数,即使程序目录下有配置文件,程序也不会读取任何参数。

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

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

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

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

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

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

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

总结

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