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

# XApuCommandId

> XApuCommandId

# XApuCommandId

定义要发送到 XAPU 或从 XAPU 接收的基本命令参数。所有其他命令都从此类型扩展而来。

## Syntax

```cpp theme={null}
typedef struct XApuCommandId {  
    XApuCommandType type;  
    uint32_t streamIndex;  
    uint32_t sequence;  
    XApuCommandOptions options;  
    void* context;  
} XApuCommandId  
```

### Members

*type*\
Type: [XApuCommandType](/reference/audio/xapu/enums/xapucommandtype)

指示硬件如何处理此命令中关联数据的命令类型。

*streamIndex*\
Type: uint32\_t

流的索引。该值应介于 0 和 [XApuConnectInputParameters::maxStreamCount](/reference/audio/xapu/structs/xapuconnectinputparameters) - 1 之间。每个流都应有唯一的索引值,由调用方负责分配此值。

*sequence*\
Type: uint32\_t

XAPU 不会修改此值,如何使用它由调用方决定。它可以用作命令序列号,该序列号会随时间递增,以便在数据包从结果队列中出来时对其进行跟踪。XAPU 不会根据此序列号重新排列数据包顺序,如果此数字倒退或与前一值之间存在间隔,XAPU 也不会返回错误。

*options*\
Type: [XApuCommandOptions](/reference/audio/xapu/enums/xapucommandoptions)

命令选项。某些选项可以应用于所有命令类型,如 [XApuCommandOptions::SignalOnCompletion](/reference/audio/xapu/enums/xapucommandoptions);另一些选项仅适用于特定命令类型,如 [XApuCommandOptions::Flush](/reference/audio/xapu/enums/xapucommandoptions) 和 [XApuCommandOptions::Decoder](/reference/audio/xapu/enums/xapucommandoptions)。

*context*\
Type: void\*

一个可选的占位符,用于存放用户数据,XAPU 将从入队命令阶段一直到出队结果阶段在内部按原样传递这些数据。调用方可以自由传递任何能够容纳在 64 位无符号值中的数据,例如时间戳。

## Remarks

[XApuCommandId](/reference/audio/xapu/structs/xapucommandid) 使用它来定义要发送到 XAPU 或从 XAPU 接收的基本命令参数。所有其他命令都从此类型扩展而来。有关解码和转换激活处理参数的详细信息,请参阅 [XApuDecodeConvertActivateCommand](/reference/audio/xapu/structs/xapudecodeconvertactivatecommand) 和 [XApuDecodeConvertCommand](/reference/audio/xapu/structs/xapudecodeconvertcommand)。有关向 XAPU 输入队列提交命令的信息,请参阅 [XApuEnqueueCommand](/reference/audio/xapu/functions/xapuenqueuecommand)。

## Requirements

**头文件:** xapu.h

**支持的平台:** XBOX Series X|S

## See also

[XApuDequeueResult](/reference/audio/xapu/functions/xapudequeueresult)\
[XApuResult](/reference/audio/xapu/structs/xapuresult)\
[XAPU](/reference/audio/xapu/xapu_members)


## Related topics

- [XApuCommandType](/zh-CN/reference/audio/xapu/enums/xapucommandtype.md)
- [XApuCommandOptions](/zh-CN/reference/audio/xapu/enums/xapucommandoptions.md)
- [XApuDecodeConvertActivateCommand](/zh-CN/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md)
- [XApuEnqueueCommand](/zh-CN/reference/audio/xapu/functions/xapuenqueuecommand.md)
- [XApuDecodeConvertCommand](/zh-CN/reference/audio/xapu/structs/xapudecodeconvertcommand.md)