> ## 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](/zh-TW/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](/zh-TW/reference/audio/xdspaudio/functions/xdspdeactivate) 將其停用。其他 XDSP 串流不會受到影響,硬體會繼續處理其命令。

## 需求

**標頭:** XDspAudio.h

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

## 概念文件

* [使用 XDSP API 進行含 Envelope 的單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [使用 XDSP API 進行單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)
* [XDSP 概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview)

## 另請參閱

[XDSP](/zh-TW/reference/audio/xdspaudio/xdspaudio_members)\
[XDspSubmitCommand](/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[使用 XDSP API 進行單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[使用 XDSP API 進行單一串流 FFT/IFFT 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)


## Related topics

- [XDspActivate](/zh-TW/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspSubmitCommand](/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)
- [XDSP 音訊](/zh-TW/reference/audio/xdspaudio/xdspaudio_members.md)
- [使用 XDSP API 進行單一串流摺積概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)
- [使用 XDSP API 進行含包絡的單一串流摺積](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)