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

# XApuCommandOptions

> XApuCommandOptions

# XApuCommandOptions

다양한 명령 유형에 대한 옵션을 정의합니다.

## Syntax

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

## Constants

| Constant | Description |
| - | - |
| None | 설정된 옵션이 없습니다. |
| SignalOnCompletion | 이 플래그는 모든 명령 유형에 적용할 수 있으며, 설정하면 명령 결과가 준비되었을 때 [XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapuconnectoutputparameters.md)가 시그널링됩니다. 이 플래그를 사용하려면 호출자가 [XApuConnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapuconnect.md)에서 [XApuConnectOptions::EnableResultReadyEvent](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapuconnectoptions.md)를 설정해야 합니다. [XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapuconnectoutputparameters.md) 설명을 참조하세요. |
| Flush | 추가 입력 데이터를 기다리지 않고 사용 가능한 출력 데이터를 해제합니다. 이 플래그는 [XApuProcessType::Process](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapuprocesstype.md)에서만 작동하며, 그렇지 않으면 무시됩니다. 이 플래그는 [XApuProcessType::DecodeConvertOpus](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapuprocesstype.md) 및 [XApuProcessType::ConvertPCM](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapuprocesstype.md)에서만 사용할 수 있습니다. |
| Decoder | 설정하면 [XApuProcessType::DecodeConvertOpus](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapuprocesstype.md) 처리 모드에서만 디코더를 리셋합니다. 이 플래그는 [XApuCommandType::Reset](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapucommandtype.md)에서만 작동하며, 그렇지 않으면 무시됩니다. 이 플래그는 시크 중 디코드-변환 케이스에서만 디코더를 리셋하는 데 사용할 수 있습니다. 시크, 루프 또는 두 스트림을 스플라이싱하는 동안 [XApuCommandOptions::Decoder](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapucommandoptions.md) 플래그와 함께 [XApuCommandType::Reset](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapucommandtype.md)을 사용할지 여부는 호출자가 결정하지만, 사용할 경우 출력의 트랜지언트 효과를 방지하기 위해 호출자가 프리롤 데이터를 제출해야 합니다. |

## Remarks

이 열거형은 명령의 결과가 준비되었을 때 시그널링하기 위해 [XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapuconnectoutputparameters.md) 메서드를 사용합니다. 디코더 명령은 [XApuProcessType::DecodeConvertOpus](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapuprocesstype.md) 메서드만 사용합니다. 그렇지 않으면 [XApuCommandType::Reset](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapucommandtype.md) 메서드를 사용하여 Opus 디코더를 리셋합니다.

Reset 명령과 함께 Decoder 플래그를 사용하면 이미 디코딩되었지만 아직 HSRC로 처리되기를 기다리는 데이터는 지우지 않습니다.

## Requirements

**Header:** xapu.h

**Supported platforms:** XBOX Series X|S

## See also

[XApuCommandId](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapucommandid.md)\
[XApuConnectOutputParameters](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapuconnectoutputparameters.md)\
[XAPU](https://docs.xbox.com/ko/reference/audio/xapu/xapu_members.md)


## Related topics

- [XApuCommandId](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapucommandid.md)
- [XApuConnectOutputParameters](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [XAPU](https://docs.xbox.com/ko/reference/audio/xapu/xapu_members.md)
- [XApuDecodeConvertActivateCommand](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md)
- [XAPU 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xapu-overview.md)