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

## Syntax

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

### Members

*lastSubmittedCommandSequence*\
Type: uint32\_t

Last command sequence that has been ingested by [XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand). This value will be larger than zero if one or more commands have been submitted, otherwise zero.

*lastProcessedCommandSequence*\
Type: uint32\_t

Last command sequence that has been processed by the hardware and ready to be consumed by the caller. This value will be larger than zero if one or more commands have been processed by XDSP, otherwise zero. This value may be greater than *firstFailedCommandSequence*.

*firstFailedCommandSequence*\
Type: uint32\_t

First Command sequence that XDSP failed to process. If this value is zero, it means no failure. If this value is greater than zero, it means there is a failure in processing the command associated with this sequence number, and the *result* error code will indicate the type of failure.

*result*\
Type: HRESULT

If *firstFailedCommandSequence* is not 0, then this parameter value represents the error code of the failure, otherwise it is `S_OK`. This will be set to XDSP\_E\_DEVICE\_FATAL\_ERROR if the hardware ran into a bad state when processing commands for this stream. The affected XDSP stream should wait for all submitted commands to be processed by the hardware by checking the **XDspStatus** and it should be deactivated using [XDspDeactivate](/reference/audio/xdspaudio/functions/xdspdeactivate) once all the commands are processed. Other XDSP streams will not be affected and hardware will continue to process their commands.

## Requirements

**Header:** XDspAudio.h

**Supported platforms:** XBOX Series X|S

## Conceptual documentation

* [Overview of a single stream Convolution with Envelope using the XDSP API](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [Overview of a single stream Convolution using the XDSP API](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)
* [XDSP overview](/build/console-features/audio/overviews/xdsp-overview)

## See also

[XDSP](/reference/audio/xdspaudio/xdspaudio_members)\
[XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[Overview of a single stream Convolution using the XDSP API](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[Overview of a single stream FFT/IFFT using the XDSP API](/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)
