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

# XApuCommandOptions

> XApuCommandOptions

# XApuCommandOptions

定義不同命令類型的選項。

## 語法

```cpp theme={null}
enum class XApuCommandOptions  : uint32_t  
{  
    None = 0,  
    SignalOnCompletion = 1,  
    Flush = 2,  
    Decoder = 4,  
}  
```

## 常數

| 常數 | 描述 |
| - | - |
| None | 未設定任何選項。 |
| SignalOnCompletion | 此旗標可套用至所有命令類型；設定之後，當命令的結果就緒時，會發出 [XApuConnectOutputParameters::resultReadyEvent](/zh-TW/reference/audio/xapu/structs/xapuconnectoutputparameters) 訊號。若要使用此旗標，呼叫端必須在 [XApuConnect](/zh-TW/reference/audio/xapu/functions/xapuconnect) 中設定 [XApuConnectOptions::EnableResultReadyEvent](/zh-TW/reference/audio/xapu/enums/xapuconnectoptions)。請參閱 [XApuConnectOutputParameters::resultReadyEvent](/zh-TW/reference/audio/xapu/structs/xapuconnectoutputparameters) 的描述。 |
| Flush | 如果有可用的輸出資料，則直接釋放，而不等待更多輸入資料。此旗標僅適用於 [XApuProcessType::Process](/zh-TW/reference/audio/xapu/enums/xapuprocesstype)，否則會遭到忽略。此旗標只能搭配 [XApuProcessType::DecodeConvertOpus](/zh-TW/reference/audio/xapu/enums/xapuprocesstype) 和 [XApuProcessType::ConvertPCM](/zh-TW/reference/audio/xapu/enums/xapuprocesstype) 使用。 |
| Decoder | 設定之後，只會在 [XApuProcessType::DecodeConvertOpus](/zh-TW/reference/audio/xapu/enums/xapuprocesstype) 處理模式中重設解碼器。此旗標僅適用於 [XApuCommandType::Reset](/zh-TW/reference/audio/xapu/enums/xapucommandtype)，否則會遭到忽略。此旗標可用於在搜尋期間，僅於解碼-轉換案例中重設解碼器。在搜尋、迴圈或拼接兩個串流期間，是否搭配 [XApuCommandOptions::Decoder](/zh-TW/reference/audio/xapu/enums/xapucommandoptions) 旗標使用 [XApuCommandType::Reset](/zh-TW/reference/audio/xapu/enums/xapucommandtype) 由呼叫端決定；但若使用，呼叫端必須提交預捲 (preroll) 資料，以避免輸出中出現暫態效應。 |

## 備註

此列舉會使用 [XApuConnectOutputParameters::resultReadyEvent](/zh-TW/reference/audio/xapu/structs/xapuconnectoutputparameters) 方法，在命令的結果就緒時發出訊號。解碼器命令僅使用 [XApuProcessType::DecodeConvertOpus](/zh-TW/reference/audio/xapu/enums/xapuprocesstype) 方法。否則，會使用 [XApuCommandType::Reset](/zh-TW/reference/audio/xapu/enums/xapucommandtype) 方法重設 Opus 解碼器。

當 Decoder 旗標搭配 Reset 命令使用時，不會清除已解碼但仍在等待處理至 HSRC 的資料。

## 需求

**標頭:** xapu.h

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

## 另請參閱

[XApuCommandId](/zh-TW/reference/audio/xapu/structs/xapucommandid)\
[XApuConnectOutputParameters](/zh-TW/reference/audio/xapu/structs/xapuconnectoutputparameters)\
[XAPU](/zh-TW/reference/audio/xapu/xapu_members)


## Related topics

- [XApuCommandOptions](/reference/audio/xapu/enums/xapucommandoptions.md)
- [XApuCommandId](/reference/audio/xapu/structs/xapucommandid.md)