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

# XDspStatus

> XDspStatus

# XDspStatus

XDSP 状态。

## 语法

```cpp theme={null}
typedef struct XDspStatus {  
    uint32_t lastSubmittedCommandSequence;  
    uint32_t lastProcessedCommandSequence;  
    uint32_t firstFailedCommandSequence;  
    HRESULT result;  
} XDspStatus  
```

### 成员

*lastSubmittedCommandSequence*\
类型：uint32\_t

[XDspSubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommand.md) 已接收的最后一个命令序号。如果已提交一条或多条命令，此值将大于零；否则为零。

*lastProcessedCommandSequence*\
类型：uint32\_t

已由硬件处理并可供调用方使用的最后一个命令序号。如果 XDSP 已处理一条或多条命令，此值将大于零；否则为零。此值可能大于 *firstFailedCommandSequence*。

*firstFailedCommandSequence*\
类型：uint32\_t

XDSP 未能处理的第一个命令序号。如果此值为零，则表示没有失败。如果此值大于零，则表示与此序号关联的命令在处理时失败，并且 *result* 错误代码将指示失败类型。

*result*\
类型：HRESULT

如果 *firstFailedCommandSequence* 不为 0，则此参数值表示失败的错误代码；否则为 `S_OK`。如果硬件在处理此流的命令时进入错误状态，则此值将设置为 XDSP\_E\_DEVICE\_FATAL\_ERROR。受影响的 XDSP 流应通过检查 **XDspStatus** 等待所有已提交的命令由硬件处理完毕，然后在所有命令处理完成后使用 [XDspDeactivate](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspdeactivate.md) 将其停用。其他 XDSP 流不会受到影响，硬件将继续处理它们的命令。

## 要求

**头文件：** XDspAudio.h

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

## 概念文档

* [使用 XDSP API 进行带包络的单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
* [使用 XDSP API 进行单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)
* [XDSP 概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview.md)

## 另请参阅

[XDSP](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspSubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)\
[使用 XDSP API 进行单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[使用 XDSP API 进行单流 FFT/IFFT 概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)


## Related topics

- [XDspActivate](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspSubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)
- [XDSP 音频](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/xdspaudio_members.md)
- [使用 XDSP API 进行单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)
- [使用 XDSP API 进行带包络的单流卷积](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)