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

# ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS

> ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS

# ACP\_COMMAND\_ENABLE\_OR\_DISABLE\_XMA\_CONTEXTS

일련의 XMA 컨텍스트를 활성화 또는 비활성화하기 위한 명령입니다.

## 구문

```cpp theme={null}
typedef struct ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS {  
    UINT32 context[SHAPE_NUM_XMA_CONTEXT_BITFIELDS];  
} ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS  
```

### 멤버

*context*\
형식: UINT32\[SHAPE\_NUM\_XMA\_CONTEXT\_BITFIELDS]

컨텍스트의 비트 필드입니다. 여기서 배열 요소 = context / 32이고, 마스크 = 1 \<\< (context % 32)입니다.

## 설명

`ACP_COMMAND_TYPE_DISABLE_XMA_CONTEXTS` 명령이 발행되면, 모든 XMA 컨텍스트가 비활성화되고 디코더가 더 이상 어떤 컨텍스트도 처리하지 않은 후에 `ACP_MESSAGE_TYPE_COMMAND_COMPLETED` 메시지가 전송됩니다. 이는 *command completed* 메시지가 수신될 때 타이틀이 자유롭게 컨텍스트 구조를 수정할 수 있음을 의미합니다.

*command completed* 메시지가 컨텍스트가 단순히 비활성화된 것으로 표시된 후가 아니라 디코더에 의해 컨텍스트가 비활성화된 후에 전송되는 이유는, XMA 디코더가 중단할 수 없는 컨텍스트 작업을 처리하는 도중일 수 있기 때문입니다. 이 동작은 XBOX 360과 동일합니다.

전체 컨텍스트 배열이 0으로 초기화된 경우, 다음을 사용하여 각 컨텍스트 인덱스의 비트를 설정합니다.

`context[contextIndex >> SHAPE_XMA_CONTEXT_INDEX_SHIFT] |= 1 << (contextIndex & SHAPE_XMA_CONTEXT_BIT_MASK);`

## 요구 사항

**헤더:** acphal.h

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 관련 항목

[ACP\_COMMAND\_TYPE](/ko/reference/audio/acphal/enums/acp_command_type)\
[SubmitCommand](/ko/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand)\
[AcpHal](/ko/reference/audio/acphal/acphal_members)


## Related topics

- [ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT](/ko/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_context.md)
- [ACP_COMMAND_TYPE](/ko/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](/ko/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](/ko/reference/audio/acphal/structs/acp_command_update_xma_context.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY](/ko/reference/audio/acphal/structs/acp_command_update_xma_context_entry.md)