Skip to main content
启用一组实验性功能。

语法

参数

NumFeatures
类型:UINT
要启用的实验性功能的数量。 pIIDs [in]
类型:const IID *
SAL__in_ecount(NumFeatures) 指向 ID 数组的指针,该数组指定要启用的可用实验性功能。 pConfigurationStructs [in]
类型:void *
SAL__in_ecount(NumFeatures) 包含某些实验性功能启用时可能需要的额外配置详细信息的结构。 pConfigurationStructSizes [in]
类型:UINT *
SAL__in_ecount(NumFeatures) pConfigurationStructs 参数中传入的任何配置结构的大小。

返回值

类型:HRESULT 此方法返回一个 HRESULT 成功或错误代码,可能包括:如果指定了未识别的功能或未启用开发者模式,则为 E_NOINTERFACE;如果功能配置不正确,或所指定的实验性功能彼此不兼容,或其他错误,则为 E_INVALIDARG。

备注

在设备创建之前调用此函数。 由于实验性功能集会随时间变化,且这些功能可能不稳定,因此仅供开发和实验使用。为此,必须先激活开发者模式才能启用任何实验性功能。 当前支持的实验性功能集可以在 D3D12.h 头文件中,D3D12EnableExperimentalFeatures 函数定义附近找到;由于实验性功能仅偶尔提供,通常会发现当前没有支持的实验性功能。 某些实验性功能可能通过使用 IID 作为 GUID 来标识。对于这些功能,您可以将 IID 作为参数传递给 D3D12GetDebugInterface 来获取用于操作该功能的接口。 如果使用不同的功能列表再次调用此函数,则所有当前的 D3D12 设备都将设置为 DEVICE_REMOVED 状态。

示例

此示例展示了实验性功能定义的样式。

要求

头文件: d3d12_xs.h 或 d3d12_x.h
库: d3d12_xs.lib 或 d3d12_x.lib
支持的平台:XBOX Series 主机和 XBOX One 系列

另请参阅

核心函数
最后修改于 2026年8月24日