IXAudio2MasteringVoice::GetChannelMask 메서드(xaudio2.h)

아티클
03/04/2024

이 음성의 채널 마스크를 반환합니다.

구문

HRESULT GetChannelMask(
  [out] DWORD *pChannelmask
);

매개 변수

[out] pChannelmask

이 음성의 채널 마스크를 반환합니다. WAVEFORMATEXTENSIBLE 구조체의 dwChannelMask 멤버에 해당합니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

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)

참고 XAUDIO의 DirectX SDK 버전의 경우 출력 디바이스의 채널 마스크는 Windows 8 이상 존재하지 않는 IXAudio2::GetDeviceDetails 메서드를 통해 가져옵니다.

플랫폼 요구 사항

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

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	xaudio2.h

추가 정보

IXAudio2MasteringVoice

Share via