FXC 任务

注意

仅当使用 C++ 生成系统时，此任务才可用。

在生成过程中使用 HLSL 着色器编译器。

参数

下表介绍了 FXC 任务的参数。

参数	描述
AdditionalIncludeDirectories	可选的 string[] 参数。 指定一个或多个要添加到包含路径中的目录；存在多个目录时，请用分号分隔。 请使用 /I[path]。
AdditionalOptions	可选的 string 参数。
AllResourcesBound	可选的 bool 参数。 编译器假定着色器可引用的所有资源已绑定，并且在着色器执行期间处于良好状态。 适用于着色器模型 5.1 及更高版本。 请使用 /all_resources_bound。
AssemblerOutput	可选的 string 参数。 指定汇编语言输出文件的内容。 请使用 /Fc, /Fx。 NoListing AssemblyCode，使用 Fc。 AssemblyCodeAndHex，使用 Fx。
AssemblerOutputFile	可选的 string 参数。 指定程序集代码清单文件的文件名。
CompileD2DCustomEffect	可选的 bool 参数。 编译包含像素着色器的 Direct2D 自定义效果。 请勿用于顶点或计算自定义效果。
ConsumeExportFile	可选的 string 参数。
DisableOptimizations	可选的 bool 参数。 禁用优化。 /Od 是指 /Gfp，但输出可能与 /Od /Gfp 不同。
EnableDebuggingInformation	可选的 bool 参数。 启用调试信息。
EnableUnboundedDescriptorTables	可选的 bool 参数。 通知编译器：着色器可能包含具有未绑定范围的资源数组的声明。 适用于着色器模型 5.1 及更高版本。 请使用 /enable_unbounded_descriptor_tables。
EntryPointName	可选的 string 参数。 为着色器指定入口点名称。 请使用 /E[name]。
GenerateExportFile	可选的 string 参数。
GenerateExportShaderProfile	可选的 string 参数。
HeaderFileOutput	可选的 string 参数。 为包含对象代码的头文件指定名称。 请使用 /Fh [name]。
ObjectFileOutput	可选的 string 参数。 为对象文件指定名称。 请使用 /Fo [name]。
PreprocessorDefinitions	可选的 string[] 参数。 为源文件定义预处理符号。
SetRootSignature	可选的 string 参数。 将根签名附加到着色器字节码。 适用于着色器模型 5.0 及更高版本。 请使用 /setrootsignature。
ShaderModel	可选的 string 参数。 指定着色器模型。 部分着色器类型只能与最新的着色器模型搭配使用。 请使用 /T [type]_[model]。
ShaderType	可选的 string 参数。 指定着色器的类型。 请使用 /T [type]_[model]。 Effect，使用 fx。 Vertex，使用 vs。 Pixel，使用 ps。 Geometry，使用 gs。 Hull，使用 hs。 Domain，使用 ds。 Compute，使用 cs。 Library，使用 lib。 RootSignature，生成根签名对象。
Source	必需的 ITaskItem 参数。
SuppressStartupBanner	可选的 bool 参数。 取消显示启动版权标志和信息消息。 请使用 /nologo。
TrackerLogDirectory	可选的 string 参数。
TreatWarningAsError	可选的 bool 参数。 将所有编译器警告视为错误。 对于新项目，最好在所有编译中使用 /WX；对所有警告进行解析可确保将可能难以发现的代码缺陷减至最少。
VariableName	可选的 string 参数。 为头文件中的变量名称指定名称。 请使用 /Vn [name]。

另请参阅

任务参考