auxSetVolume 함수(mmeapi.h)

auxSetVolume 함수는 지정된 보조 출력 디바이스의 볼륨을 설정합니다.

구문

MMRESULT auxSetVolume(
  UINT  uDeviceID,
  DWORD dwVolume
);

매개 변수

uDeviceID

쿼리할 보조 출력 디바이스의 식별자입니다. 디바이스 식별자는 시스템에 있는 디바이스 수에서 암시적으로 결정됩니다. 디바이스 식별자 값은 0에서 1까지의 범위가 있는 디바이스 수보다 작습니다. auxGetNumDevs 함수를 사용하여 시스템의 보조 디바이스 수를 확인합니다.

dwVolume

새 볼륨 설정을 지정합니다. 하위 단어는 왼쪽 채널 볼륨 설정을 지정하고, 상위 단어는 오른쪽 채널 설정을 지정합니다. 0xFFFF 값은 전체 볼륨을 나타내고 0x0000 값은 무음입니다.

디바이스가 왼쪽 및 오른쪽 볼륨 제어를 모두 지원하지 않는 경우 dwVolume 의 하위 단어는 볼륨 수준을 지정하고 상위 단어는 무시됩니다.

반환 값

성공하면 MMSYSERR_NOERROR 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드	설명
MMSYSERR_BADDEVICEID	지정된 디바이스 식별자가 범위를 벗어났습니다.

설명

모든 디바이스가 볼륨 제어를 지원하는 것은 아닙니다. 디바이스가 볼륨 제어를 지원하는지 여부를 확인하려면 AUXCAPS_VOLUME 플래그를 사용하여 AUXCAPS 구조체의 dwSupport 멤버를 테스트합니다(auxGetDevCaps 함수로 채워짐).

디바이스가 왼쪽 채널과 오른쪽 채널 모두에서 볼륨 제어를 지원하는지 여부를 확인하려면 AUXCAPS_LRVOLUME 플래그를 사용하여 AUXCAPS 구조체의 dwSupport 멤버를 테스트합니다(auxGetDevCaps로 채워짐).

대부분의 디바이스는 전체 16비트 볼륨 수준 제어를 지원하지 않으며 요청된 볼륨 설정의 상위 비트만 사용합니다. 예를 들어 4비트 볼륨 제어를 지원하는 디바이스의 경우 요청된 볼륨 수준 값인 0x4000, 0x4FFF 및 0x43BE 0x4000 동일한 물리적 볼륨 설정을 생성합니다. auxGetVolume 함수는 auxSetVolume으로 설정된 전체 16비트 설정을 반환합니다.

볼륨 설정은 로그적으로 해석됩니다. 즉, 볼륨 수준을 0x4000 0x5000 0x5000 0x6000 늘릴 때 인식된 볼륨 증가가 동일합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	mmeapi.h(Windows.h 포함)
라이브러리	Winmm.lib
DLL	Winmm.dll

추가 정보

파형 오디오

파형 함수