> ## 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.

# InitializeMetaCommand (XBOX Series 主机)

> 初始化指定的元命令。

初始化指定的元命令。

在执行元命令之前（在 GPU 的时间线上），你必须至少初始化一次元命令。初始化为实现提供机会执行加速元命令调用所需的任何工作。你必须提供足够的资源参数，包括持久缓存资源。

## 语法

```cpp theme={null}
void InitializeMetaCommand(
    ID3D12MetaCommand  pMetaCommand,
    const void  pInitializationParametersData,
    SIZE_T InitializationParametersDataSizeInBytes
)
```

### 参数

*pMetaCommand \[in]*\
类型：ID3D12MetaCommand \*

指向表示要初始化的元命令的 [ID3D12MetaCommand](/reference/graphics/d3d12/interfaces/id3d12metacommand/id3d12metacommand_public) 的指针。

*pInitializationParametersData \[in, optional]*\
类型：const void \*

一个可选指针，指向包含用于初始化元命令的参数值的常量结构。

*InitializationParametersDataSizeInBytes \[in]*\
类型：SIZE\_T

一个 [SIZE\_T](https://learn.microsoft.com/en-us/windows/desktop/WinProg/windows-data-types)，包含由 <i>pInitializationParametersData</i> 指向的结构的大小（如果已设置），否则为 0。

### 返回值

类型：void

如果此方法成功，则返回 **S\_OK**。否则，返回 **HRESULT** 错误代码。

## 要求

**头文件：** d3d12\_xs.h\
**库：** d3d12\_xs.lib\
**支持的平台**：XBOX Series 主机

## 另请参阅

[ID3D12GraphicsCommandList4](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [CreateMetaCommand (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_createmetacommand_public.md)
- [EnumerateMetaCommands (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_enumeratemetacommands_public.md)
- [EnumerateMetaCommandParameters (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_enumeratemetacommandparameters_public.md)
- [CreateCommandQueue1 (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_createcommandqueue1_public.md)
- [CreateCommandList1 (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createcommandlist1_public.md)