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

# 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 概述](/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 主机

## 另请参阅

[GetXmaChannelMaskFromStandardMask](/reference/audio/xma2defs/functions/getxmachannelmaskfromstandardmask)\
[xma2defs](/reference/audio/xma2defs/xma2defs_members)


## Related topics

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