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

# XApuConnectOutputParameters

> XApuConnectOutputParameters

# XApuConnectOutputParameters

[XApuConnect](/reference/audio/xapu/functions/xapuconnect) 返回的参数。

## Syntax

```cpp theme={null}
typedef struct XApuConnectOutputParameters {  
    void* baseData;  
    HANDLE resultReadyEvent;  
} XApuConnectOutputParameters  
```

### Members

*baseData*\
Type: void\*

如果 [XApuConnect](/reference/audio/xapu/functions/xapuconnect) 成功,则为已分配系统内存的基虚拟地址,可将其映射到设备空间;否则为 nullptr。调用方应使用此内存来传递输入数据并检索输出数据。此外,调用方必须使用此内存来设置处理缓冲区。

此缓冲区按 16 字节对齐,如何将此内存划分为输入、输出和处理缓冲区由调用方决定。

*resultReadyEvent*\
Type: HANDLE

如果设置了 [XApuConnectOptions::EnableResultReadyEvent](/reference/audio/xapu/enums/xapuconnectoptions) 标志且 [XApuConnect](/reference/audio/xapu/functions/xapuconnect) 成功,则为有效的 Win32 事件句柄;否则为 nullptr。当设置了 [XApuCommandOptions::SignalOnCompletion](/reference/audio/xapu/enums/xapucommandoptions) 标志的命令结果就绪时,将向此 Win32 事件句柄发出信号。此信号运行于每三毫秒触发一次的计时器上。如果有一个或多个 XApuResult 就绪,它将发出一次信号。也就是说,当在这三毫秒周期内有多个结果就绪并且所有这些结果都设置了 XApuCommandOptions::SignalOnCompletion 标志时,该事件仅会发出一次信号。

在事件被发出信号后应调用 [XApuGetResultCount](/reference/audio/xapu/functions/xapugetresultcount) 以确定有多少 XApuResult 就绪。当在 XAPU 客户端上激活多个流时,不建议设置 [XApuCommandOptions::SignalOnCompletion](/reference/audio/xapu/enums/xapucommandoptions),因为这可能会降低整体性能;相反,调用方应为一组命令仅设置一次 SignalOnCompletion 标志。例如,仅为特定流的所有命令设置 SignalOnCompletion,而不为其他已激活的流设置。

## Remarks

`XApuConnectOutputParameter` 使用它传递 `XApuConnect` 返回的参数。`XApuConnect` 为音频处理单元 (XAPU) 分配所需资源。有关从处理引擎断开连接并释放在 `XApuConnect` 期间分配的所有资源的详细信息,请参阅 [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect)。有关命令选项的详细信息,请参阅 [XApuCommandOptions](/reference/audio/xapu/enums/xapucommandoptions)。

## Requirements

**头文件:** xapu.h

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

## See also

[XApuDecodeConvertCommand](/reference/audio/xapu/structs/xapudecodeconvertcommand)\
[XAPU](/reference/audio/xapu/xapu_members)


## Related topics

- [XApuConnect](/zh-CN/reference/audio/xapu/functions/xapuconnect.md)
- [XApuCommandOptions](/zh-CN/reference/audio/xapu/enums/xapucommandoptions.md)
- [XApuDisconnect](/zh-CN/reference/audio/xapu/functions/xapudisconnect.md)
- [XApuConnectOptions](/zh-CN/reference/audio/xapu/enums/xapuconnectoptions.md)
- [使用 XAPU API 进行单流 Opus 音频解码](/zh-CN/build/console-features/audio/overviews/xapu-overview-single-stream-audio-decode.md)