Метод IXAudio2MasteringVoice::GetChannelMask (xaudio2.h)

Статья
03/13/2024

Возвращает маску канала для этого голоса.

Синтаксис

HRESULT GetChannelMask(
  [out] DWORD *pChannelmask
);

Параметры

[out] pChannelmask

Возвращает маску канала для этого голоса. Соответствует члену dwChannelMask структуры WAVEFORMATEXTENSIBLE .

Возвращаемое значение

Этот метод не возвращает значение.

Аргумент pChannelMask представляет собой битовую маску различных каналов в геометрии динамика, сообщаемой аудиосистемой. Эти сведения необходимы для параметра X3DAudioInitializeSpeakerChannelMask .

The X3DAUDIO. Заголовок H объявляет ряд SPEAKER_ позиционных определений для декодирования этих масок каналов.

Примеры приведены ниже.

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)

Примечание Для версий пакета SDK для DirectX XAUDIO маска канала для устройства вывода была получена с помощью метода IXAudio2::GetDeviceDetails, который не существует в Windows 8 и более поздних версиях.

Требования к платформе

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

Требования

Требование	Значение
Целевая платформа	Windows
Header	xaudio2.h

См. также раздел

IXAudio2MasteringVoice

Поделиться через