> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateCommandSignature

> 此方法创建命令签名。

此方法创建命令签名。

## 语法

```cpp theme={null}
HRESULT CreateCommandSignature(
    const D3D12_COMMAND_SIGNATURE_DESC  pDesc,
    ID3D12RootSignature  pRootSignature,
    const IID & riid,
    void  ppvCommandSignature
)
```

### 参数

*pDesc \[in]*\
类型：const D3D12\_COMMAND\_SIGNATURE\_DESC \*

使用 [D3D12\_COMMAND\_SIGNATURE\_DESC](/reference/graphics/d3d12/structs/d3d12_command_signature_desc_public) 结构体描述要创建的命令签名。

*pRootSignature \[in, optional]*\
类型：ID3D12RootSignature \*

指定命令签名应用于的 [ID3D12RootSignature](/reference/graphics/d3d12/interfaces/id3d12rootsignature/id3d12rootsignature_public)。

如果签名中的任何命令将更新管道上的绑定，则需要根签名。如果存在的唯一命令是绘制或调度，则根签名参数可设置为 NULL。

*riid*\
类型：const IID &

命令签名接口（[ID3D12CommandSignature](/reference/graphics/d3d12/interfaces/id3d12commandsignature/id3d12commandsignature_public)）的全局唯一标识符 (**GUID**)。
可以使用 \_\_uuidof() 宏获取命令签名接口的 **REFIID** 或 **GUID**。
例如，\_\_uuidof(**ID3D12CommandSignature**) 将获取命令签名接口的 **GUID**。

*ppvCommandSignature \[out, optional]*\
类型：void \*\*

指定一个指针，在成功完成该方法后，将指向创建的命令签名（[ID3D12CommandSignature](/reference/graphics/d3d12/interfaces/id3d12commandsignature/id3d12commandsignature_public)）。

### 返回值

类型：HRESULT

此方法返回 [Direct3D 12 返回代码](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) 之一。

## 要求

**头文件：** d3d12\_xs.h 或 d3d12\_x.h\
**库：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支持的平台**：XBOX Series 主机和 XBOX One 系列

## 另请参阅

[ID3D12Device](/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)


## Related topics

- [D3D12_COMMAND_SIGNATURE_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_command_signature_desc_public.md)
- [ID3D12CommandSignature](/zh-CN/reference/graphics/d3d12/interfaces/id3d12commandsignature/id3d12commandsignature_public.md)
- [CreateRootSignature](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createrootsignature_public.md)
- [D3D12CreateRootSignatureDeserializer](/zh-CN/reference/graphics/d3d12/functions/d3d12createrootsignaturedeserializer_public.md)
- [D3D12CreateVersionedRootSignatureDeserializer](/zh-CN/reference/graphics/d3d12/functions/d3d12createversionedrootsignaturedeserializer_public.md)