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

Convertit les masques de canaux `WAVEFORMATEXTENSIBLE`, qui sont des combinaisons d'indicateurs `SPEAKER_xxx` définis dans le fichier *audiodef.h*, en masques de canaux XBOX Media Audio (XMA), limités à huit positions de haut-parleurs possibles.

## Syntaxe

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

### Paramètres

*dwStandardMask*   \
Type : DWORD

Masque standard.

### Valeur de retour

Type : BYTE

Masque d'octet.

## Remarques

Cette fonction convertit les masques de canaux `WAVEFORMATEXTENSIBLE`, qui sont des combinaisons d'indicateurs `SPEAKER_xxx` définis dans le fichier *audiodefs.h*, en masques de canaux XMA, limités à huit positions de haut-parleurs possibles.

Comme le montre l'exemple de code ci-dessous, ces positions de haut-parleurs comprennent gauche, droite, centre, basses fréquences, latéral gauche, latéral droit, arrière gauche et arrière droit.

```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;
}
```

Pour plus d'informations sur XMA2, consultez [Vue d'ensemble de XMA2](/fr/build/console-features/audio/overviews/xma2-overview). Pour une vue d'ensemble de l'architecture audio de la XBOX One, consultez **The sound of the future** : [L'architecture audio de la XBOX One](/fr/build/console-features/audio/overviews/xbox-one-audio-architecture).

## Configuration requise

**En-tête :** xma2defs.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

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


## Related topics

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