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

# 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](/reference/audio/xdspaudio/functions/xdspsubmitcommand) 已接收的最后一个命令序号。如果已提交一条或多条命令，此值将大于零；否则为零。

*lastProcessedCommandSequence*\
类型：uint32\_t

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

*firstFailedCommandSequence*\
类型：uint32\_t

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

*result*\
类型：HRESULT

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

## 要求

**头文件：** XDspAudio.h

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

## 概念文档

* [使用 XDSP API 进行带包络的单流卷积概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [使用 XDSP API 进行单流卷积概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)
* [XDSP 概述](/build/console-features/audio/overviews/xdsp-overview)

## 另请参阅

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