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

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

## Syntax

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

## Constants

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

## Remarks

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

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

## Requirements

**Header:** xapu.h

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

## See also

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


## Related topics

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