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

Convierte entre las máscaras de canal `WAVEFORMATEXTENSIBLE`, que son combinaciones de las marcas `SPEAKER_xxx` definidas en el archivo *audiodef.h*, y las máscaras de canal de XBOX Media Audio (XMA), y está limitada a ocho posiciones de altavoz posibles.

## Sintaxis

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

### Parámetros

*dwStandardMask*   \
Tipo: DWORD

Máscara estándar.

### Valor devuelto

Tipo: BYTE

Máscara de bytes.

## Comentarios

Esta función convierte entre las máscaras de canal `WAVEFORMATEXTENSIBLE`, que son combinaciones de las marcas `SPEAKER_xxx` definidas en el archivo *audiodefs.h*, y las máscaras de canal de XMA, y está limitada a ocho posiciones de altavoz posibles.

Como se muestra en el ejemplo de código siguiente, estas posiciones de altavoz incluyen izquierda, derecha, centro, baja frecuencia, lateral izquierda, lateral derecha, trasera izquierda y trasera derecha.

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

Para obtener más información sobre XMA2, consulte [Información general de XMA2](/build/console-features/audio/overviews/xma2-overview). Para obtener información general de la arquitectura de audio de XBOX One, consulte **El sonido del futuro**: [La arquitectura de audio en XBOX One](/build/console-features/audio/overviews/xbox-one-audio-architecture).

## Requisitos

**Encabezado:** xma2defs.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

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