> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XDspDeactivate

> XDspDeactivate

# XDspDeactivate

停用某个流，并将 [XDspActivate](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspactivate.md) 中获取的处理资源归还到池中。

## 语法

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

### 参数

*handle*   \_In\_\
类型：[XDspStreamHandle](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/handles/xdspstreamhandle.md)

通过调用 [XDspActivate](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspactivate.md) 创建的句柄。

### 返回值

类型：HRESULT

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

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

## 备注

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

## 要求

**头文件：** XDspAudio.h

**库：** Chad.lib

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

## 概念文档

* [使用 XDSP API 进行带包络的单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)
* [使用 XDSP API 进行单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)
* [XDSP 概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview.md)

## 另请参阅

[XDSP](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/xdspaudio_members.md)\
[XDspActivate](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/functions/xdspactivate.md)\
[XDSP Errors](https://docs.xbox.com/zh-CN/reference/audio/xdspaudio/enums/xdsperrors.md)\
[使用 XDSP API 进行单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution.md)\
[使用 XDSP API 进行单流 FFT/IFFT 概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft.md)\
[使用 XDSP API 进行带包络的单流卷积概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)


## Related topics

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