> ## 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](/zh-TW/reference/audio/xapu/functions/xapuconnect) 傳回的參數。

## 語法

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

### 成員

*baseData*\
類型：void\*

如果 [XApuConnect](/zh-TW/reference/audio/xapu/functions/xapuconnect) 成功，則為可對應至裝置空間之已配置系統記憶體的基底虛擬位址，否則為 nullptr。呼叫端應使用此記憶體來傳遞輸入資料及擷取輸出資料。此外，呼叫端必須使用此記憶體來設定處理緩衝區。

此緩衝區為 16 位元組對齊，如何將此記憶體分割為輸入、輸出和處理緩衝區由呼叫端決定。

*resultReadyEvent*\
類型：HANDLE

如果已設定 [XApuConnectOptions::EnableResultReadyEvent](/zh-TW/reference/audio/xapu/enums/xapuconnectoptions) 旗標且 [XApuConnect](/zh-TW/reference/audio/xapu/functions/xapuconnect) 成功，則為有效的 Win32 事件控制代碼，否則為 nullptr。當已設定 [XApuCommandOptions::SignalOnCompletion](/zh-TW/reference/audio/xapu/enums/xapucommandoptions) 旗標之命令的結果就緒時，此 Win32 事件控制代碼會收到訊號。此訊號是在每三毫秒觸發一次的計時器上執行。如果有一或多個 XApuResult 就緒，它會發出一次訊號。也就是說，當三毫秒期間內有多個結果就緒，且這些結果都已設定 XApuCommandOptions::SignalOnCompletion 旗標時，事件只會收到一次訊號。

事件收到訊號後，應呼叫 [XApuGetResultCount](/zh-TW/reference/audio/xapu/functions/xapugetresultcount) 以找出有多少個 XApuResult 已就緒。當 XAPU 用戶端上啟用了多個串流時，不建議設定 [XApuCommandOptions::SignalOnCompletion](/zh-TW/reference/audio/xapu/enums/xapucommandoptions)，因為這可能會降低整體效能，呼叫端應改為針對一組命令設定一次 SignalOnCompletion 旗標。例如，只針對特定串流的所有命令設定 SignalOnCompletion，而不要針對其他已啟用的串流設定。

## 備註

由 `XApuConnectOutputParameter` 用來傳遞 `XApuConnect` 傳回的參數。`XApuConnect` 會為音訊處理單元 (XAPU) 配置必要的資源。如需中斷與處理引擎的連線，以及釋放在 `XApuConnect` 期間配置之所有資源的詳細資訊，請參閱 [XApuDisconnect](/zh-TW/reference/audio/xapu/functions/xapudisconnect)。如需命令選項的詳細資訊，請參閱 [XApuCommandOptions](/zh-TW/reference/audio/xapu/enums/xapucommandoptions)。

## 需求

**標頭：** xapu.h

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

## 另請參閱

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


## Related topics

- [XApuConnectOutputParameters](/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [XApuConnect](/reference/audio/xapu/functions/xapuconnect.md)
- [XApuCommandOptions](/reference/audio/xapu/enums/xapucommandoptions.md)