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

*audiodef.h* ファイルで定義された `SPEAKER_xxx` フラグの組み合わせである `WAVEFORMATEXTENSIBLE` チャネル マスクと、XBOX Media Audio (XMA) チャネル マスクとの間で変換します。

## 構文

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

### パラメーター

*bXmaMask*   \
型: BYTE

入力バイト マスク。

### 戻り値

型: DWORD

標準マスク。

## 解説

この関数は、*audiodef.h* ファイルで定義された `SPEAKER_xxx` フラグの組み合わせである `WAVEFORMATEXTENSIBLE` チャネル マスクと、XMA チャネル マスクとの間で変換します。8 つの可能なスピーカー位置に制限されます。

以下のコード例に示すように、これらのスピーカー位置には左、右、中央、低周波、サイド左、サイド右、バック左、バック右が含まれます。

```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/ja-jp/build/console-features/audio/overviews/xma2-overview.md)を参照してください。XBOX One のオーディオ アーキテクチャの概要については、**未来のサウンド**: [XBOX One のオーディオ アーキテクチャ](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xbox-one-audio-architecture.md)を参照してください。

## 要件

**ヘッダー:** xma2defs.h

**サポートされるプラットフォーム:** XBOX One ファミリ本体および XBOX Series 本体

## 関連項目

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


## Related topics

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