Skip to main content

XDspStatus

XDSP status.

Syntax

Members

lastSubmittedCommandSequence
Type: uint32_t
Last command sequence that has been ingested by 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 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

See also

XDSP
XDspSubmitCommand
Overview of a single stream Convolution using the XDSP API
Overview of a single stream FFT/IFFT using the XDSP API
Last modified on August 20, 2026