DirectX修复工具使用技巧之三——命令行与配置文件参数介绍
- VBcom
- 2023-03-26
- 3196
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修复工具参数的问题都可以参见此篇文档,如有其他疑问也可与作者联系。
发表评论