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

# XDspDeactivate

> XDspDeactivate

# XDspDeactivate

停用某个流，并将 [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate) 中获取的处理资源归还到池中。

## 语法

```cpp theme={null}
HRESULT XDspDeactivate(  
         XDspStreamHandle handle  
)  
```

### 参数

*handle*   \_In\_\
类型：[XDspStreamHandle](/reference/audio/xdspaudio/handles/xdspstreamhandle)

通过调用 [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate) 创建的句柄。

### 返回值

类型：HRESULT

成功时返回 S\_OK。如果方法失败，则返回下列代码之一（部分列表）：

| 返回代码                      | 说明                                                             |
| ------------------------- | -------------------------------------------------------------- |
| XDSP\_E\_PENDING\_RESULTS | 在收到所有已提交命令的结果之前，XDspStream 已被停用。请在停用流之前等待足够时间，让硬件完成对流已提交命令的处理。 |

## 备注

如果并非所有已提交的命令都已处理完毕，此调用将失败。

## 要求

**头文件：** XDspAudio.h

**库：** Chad.lib

**支持的平台：** 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)\
[XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate)\
[XDSP Errors](/reference/audio/xdspaudio/enums/xdsperrors)\
[使用 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)\
[使用 XDSP API 进行带包络的单流卷积概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)


## Related topics

- [XDSP 概述](/zh-CN/build/console-features/audio/overviews/xdsp-overview.md)
- [使用 XDSP API 进行单流卷积概述](/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)
- [使用 XDSP API 进行带包络的单流卷积](/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
- [使用 XDSP API 进行单流 FFT/IFFT 概述](/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)
- [XDspSubmitCommand](/zh-CN/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)