auxGetVolume 함수(mmeapi.h)

auxGetVolume 함수는 지정된 보조 출력 디바이스의 현재 볼륨 설정을 검색합니다.

구문

MMRESULT auxGetVolume(
  UINT    uDeviceID,
  LPDWORD pdwVolume
);

uDeviceID

쿼리할 보조 출력 디바이스의 식별자입니다.

pdwVolume

현재 볼륨 설정으로 채울 변수에 대한 포인터입니다. 이 위치의 하위 단어에는 왼쪽 채널 볼륨 설정이 포함되며, 상위 단어에는 오른쪽 채널 설정이 포함됩니다. 0xFFFF 값은 전체 볼륨을 나타내고 0x0000 값은 무음입니다.

디바이스가 왼쪽 및 오른쪽 볼륨 제어를 모두 지원하지 않는 경우 지정된 위치의 하위 순서 단어에는 볼륨 수준이 포함됩니다.

디바이스가 전체 16비트 볼륨 수준 제어를 지원하는지 여부에 관계없이 auxSetVolume 함수를 사용하여 설정된 전체 16비트 설정이 반환됩니다.

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

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

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

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

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