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

Converte entre máscaras de canal `WAVEFORMATEXTENSIBLE`, que são combinações de sinalizadores `SPEAKER_xxx` definidos no arquivo *audiodef.h*, e as máscaras de canal do XBOX Media Audio (XMA).

## Sintaxe

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

### Parâmetros

*bXmaMask*   \
Tipo: BYTE

Máscara de bytes de entrada.

### Valor retornado

Tipo: DWORD

Máscara padrão.

## Comentários

Essa função converte máscaras de canal `WAVEFORMATEXTENSIBLE`, que são combinações de sinalizadores `SPEAKER_xxx` definidos no arquivo *audiodef.h*, e máscaras de canal XMA, e é limitada a oito posições de alto-falante possíveis.

Conforme mostrado no exemplo de código abaixo, essas posições de alto-falante incluem esquerda, direita, centro, baixa frequência, lateral esquerda, lateral direita, traseira esquerda e traseira direita.

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

Para obter mais informações sobre o XMA2, confira [Visão geral do XMA2](/pt-BR/build/console-features/audio/overviews/xma2-overview). Para obter uma visão geral da arquitetura de áudio do XBOX One, confira **O som do futuro**: [A arquitetura de áudio no XBOX One](/pt-BR/build/console-features/audio/overviews/xbox-one-audio-architecture).

## Requisitos

**Cabeçalho:** xma2defs.h

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

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


## Related topics

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