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

# GetXmaChannelMaskFromStandardMask

> GetXmaChannelMaskFromStandardMask

# GetXmaChannelMaskFromStandardMask

*audiodef.h* 파일에 정의된 `SPEAKER_xxx` 플래그의 조합인 `WAVEFORMATEXTENSIBLE` 채널 마스크, XBOX Media Audio(XMA) 채널 마스크 간에 변환하며 8개의 가능한 스피커 위치로 제한됩니다.

## 구문

```cpp theme={null}
BYTE GetXmaChannelMaskFromStandardMask(  
         DWORD dwStandardMask  
)  
```

### 매개 변수

*dwStandardMask*   \
형식: DWORD

표준 마스크입니다.

### 반환 값

형식: BYTE

바이트 마스크입니다.

## 설명

이 함수는 *audiodefs.h* 파일에 정의된 `SPEAKER_xxx` 플래그의 조합인 `WAVEFORMATEXTENSIBLE` 채널 마스크, XMA 채널 마스크 간에 변환하며 8개의 가능한 스피커 위치로 제한됩니다.

아래의 코드 예제에서와 같이, 이러한 스피커 위치에는 왼쪽, 오른쪽, 가운데, 저주파, 사이드 왼쪽, 사이드 오른쪽, 뒤쪽 왼쪽, 뒤쪽 오른쪽이 포함됩니다.

```cpp theme={null}
__inline BYTE GetXmaChannelMaskFromStandardMask(DWORD dwStandardMask)
{
    BYTE bXmaMask = 0;

    if (dwStandardMask & SPEAKER_FRONT_LEFT)    bXmaMask |= XMA_SPEAKER_LEFT;
    if (dwStandardMask & SPEAKER_FRONT_RIGHT)   bXmaMask |= XMA_SPEAKER_RIGHT;
    if (dwStandardMask & SPEAKER_FRONT_CENTER)  bXmaMask |= XMA_SPEAKER_CENTER;
    if (dwStandardMask & SPEAKER_LOW_FREQUENCY) bXmaMask |= XMA_SPEAKER_LFE;
    if (dwStandardMask & SPEAKER_SIDE_LEFT)     bXmaMask |= XMA_SPEAKER_LEFT_SURROUND;
    if (dwStandardMask & SPEAKER_SIDE_RIGHT)    bXmaMask |= XMA_SPEAKER_RIGHT_SURROUND;
    if (dwStandardMask & SPEAKER_BACK_LEFT)     bXmaMask |= XMA_SPEAKER_LEFT_BACK;
    if (dwStandardMask & SPEAKER_BACK_RIGHT)    bXmaMask |= XMA_SPEAKER_RIGHT_BACK;

    return bXmaMask;
}
```

XMA2에 대한 자세한 내용은 [XMA2 개요](/build/console-features/audio/overviews/xma2-overview)를 참조하세요. XBOX One의 오디오 아키텍처 개요는 **미래의 사운드**: [XBOX One의 오디오 아키텍처](/build/console-features/audio/overviews/xbox-one-audio-architecture)를 참조하세요.

## 요구 사항

**헤더:** xma2defs.h

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

## 관련 항목

[GetStandardChannelMaskFromXmaMask](/reference/audio/xma2defs/functions/getstandardchannelmaskfromxmamask)\
[xma2defs](/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [GetStandardChannelMaskFromXmaMask](/ko/reference/audio/xma2defs/functions/getstandardchannelmaskfromxmamask.md)
- [XMA2Defs](/ko/reference/audio/xma2defs/xma2defs_members.md)
- [XMA2STREAMFORMAT](/ko/reference/audio/xma2defs/structs/xma2streamformat.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](/ko/reference/audio/acphal/structs/acp_command_update_xma_context.md)
- [chat_manager::get_thread_affinity_mask](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_thread_affinity_mask.md)