Método IXAudio2MasteringVoice::GetChannelMask (xaudio2.h)

  • Artigo

Retorna a máscara de canal para essa voz.

Sintaxe

HRESULT GetChannelMask(
  [out] DWORD *pChannelmask
);

Parâmetros

[out] pChannelmask

Retorna a máscara de canal para essa voz. Isso corresponde ao membro dwChannelMask da estrutura WAVEFORMATEXTENSIBLE .

Retornar valor

Esse método não retorna um valor.

Comentários

O argumento pChannelMask é uma máscara de bits dos vários canais na geometria do alto-falante relatada pelo sistema de áudio. Essas informações são necessárias para o parâmetro X3DAudioInitializeSpeakerChannelMask .

O X3DAUDIO. O cabeçalho H declara uma série de SPEAKER_ define posicionais para decodificar essas máscaras de canais.

Os exemplos incluem:

SPEAKER_STEREO // SPEAKER_FRONT_LEFT (0x1) | SPEAKER_FRONT_RIGHT (0x2) 

SPEAKER_5POINT1 // SPEAKER_FRONT_LEFT (0x1) | SPEAKER_FRONT_RIGHT (0x2)
                                    // | SPEAKER_FRONT_CENTER (0x4)
                                    // | SPEAKER_LOW_FREQUENCY (0x8)
                                    // | SPEAKER_BACK_LEFT (0x10) | SPEAKER_BACK_RIGHT (0x20)
Nota Para as versões do SDK do DirectX do XAUDIO, a máscara de canal para o dispositivo de saída foi obtida por meio do método IXAudio2::GetDeviceDetails, que não existe em Windows 8 e posteriores.
 

Requisitos da plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8)

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho xaudio2.h

Confira também

IXAudio2MasteringVoice