Skip to main content
创建根签名布局。

语法

参数

nodeMask [in]
类型:UINT
对于单 GPU 操作,将其设置为零。如果有多个 GPU 节点,则设置位以标识要将根签名应用于的节点(设备的物理适配器)。 掩码中的每一位都对应一个节点。 请参阅 多适配器系统 pBlobWithRootSignature [in]
类型:const void *
指向序列化签名的源数据的指针。 blobLengthInBytes [in]
类型:SIZE_T
pBlobWithRootSignature 指向的内存块的大小(以字节为单位)。 riid
类型:const IID &
根签名接口的全局唯一标识符 (GUID)。请参阅备注。 输入参数。 ppvRootSignature [out]
类型:void **
指向内存块的指针,该内存块接收指向根签名的指针。

返回值

类型:HRESULT 如果成功,则返回 S_OK;否则,返回 Direct3D 12 返回代码 之一。 如果 pBlobWithRootSignature 指向的 blob 无效,此方法返回 E_INVALIDARG

备注

如果应用程序按程序生成 D3D12_ROOT_SIGNATURE_DESC 数据结构,则必须在对 D3D12SerializeRootSignature 的调用中传递指向此 D3D12_ROOT_SIGNATURE_DESC 的指针以生成序列化形式。 然后,应用程序在对 ID3D12Device::CreateRootSignature 的调用中将序列化形式传递给 pBlobWithRootSignature 可以使用 __uuidof() 宏获取根签名布局接口的 REFIIDGUID。 例如,__uuidof(ID3D12RootSignature) 将获取根签名接口的 GUID

示例

D3D12HelloTriangle 示例按以下方式使用 ID3D12Device::CreateRootSignature 创建一个空的根签名。

要求

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

另请参阅

ID3D12Device
最后修改于 2026年8月24日