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

# GetStandardChannelMaskFromXmaMask

> GetStandardChannelMaskFromXmaMask

# GetStandardChannelMaskFromXmaMask

在 `WAVEFORMATEXTENSIBLE` 聲道遮罩 (由 *audiodef.h* 檔案中定義的 `SPEAKER_xxx` 旗標組合而成) 與 XBOX Media Audio (XMA) 聲道遮罩之間進行轉換。

## 語法

```cpp theme={null}
DWORD GetStandardChannelMaskFromXmaMask(  
         BYTE bXmaMask  
)  
```

### 參數

*bXmaMask*   \
類型:BYTE

輸入位元組遮罩。

### 傳回值

類型:DWORD

標準遮罩。

## 備註

此函式會轉換 `WAVEFORMATEXTENSIBLE` 聲道遮罩 (由 *audiodef.h* 檔案中定義的 `SPEAKER_xxx` 旗標組合而成) 與 XMA 聲道遮罩,且限制為八個可能的喇叭位置。

如下列程式碼範例所示,這些喇叭位置包括左、右、中央、低頻、左側、右側、左後和右後。

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

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

    return dwStandardMask;
}
```

如需 XMA2 的詳細資訊,請參閱 [XMA2 概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xma2-overview.md)。如需 XBOX One 音訊架構的概觀,請參閱**未來之聲**:[XBOX One 中的音訊架構](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xbox-one-audio-architecture.md)。

## 需求

**標頭:** xma2defs.h

**支援的平台:** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[GetXmaChannelMaskFromStandardMask](https://docs.xbox.com/zh-TW/reference/audio/xma2defs/functions/getxmachannelmaskfromstandardmask.md)\
[xma2defs](https://docs.xbox.com/zh-TW/reference/audio/xma2defs/xma2defs_members.md)


## Related topics

- [GetXmaChannelMaskFromStandardMask](https://docs.xbox.com/zh-TW/reference/audio/xma2defs/functions/getxmachannelmaskfromstandardmask.md)
- [XMA2Defs](https://docs.xbox.com/zh-TW/reference/audio/xma2defs/xma2defs_members.md)
- [XMA2STREAMFORMAT](https://docs.xbox.com/zh-TW/reference/audio/xma2defs/structs/xma2streamformat.md)
- [get_thread_affinity_mask](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_thread_affinity_mask.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/acphal/structs/acp_command_update_xma_context.md)