Share via

waveOutGetPlaybackRate 함수(mmeapi.h)

  • 아티클

waveOutGetPlaybackRate 함수는 지정된 파형 오디오 출력 디바이스에 대한 현재 재생 속도를 검색합니다.

구문

MMRESULT waveOutGetPlaybackRate(
  HWAVEOUT hwo,
  LPDWORD  pdwRate
);

매개 변수

hwo

파형 오디오 출력 디바이스에 대한 핸들입니다.

pdwRate

현재 재생 속도로 채울 변수에 대한 포인터입니다. 재생 속도 설정은 원래 작성된 설정의 현재 재생 속도 변경을 나타내는 승수입니다. 재생 속도 승수는 양수 값이어야 합니다.

속도는 고정 소수점 값으로 지정됩니다. 변수의 상위 단어에는 숫자의 부호 있는 정수 부분이 포함되고 하위 단어에는 소수 부분이 포함됩니다. 하위 단어의 0x8000 값은 반을 나타내고 0x4000 1/4를 나타냅니다. 예를 들어 0x00010000 값은 1.0의 승수를 지정하고(재생 속도 변경 없음), 0x000F8000 값은 15.5의 승수를 지정합니다.

반환 값

성공하거나 오류가 있으면 MMSYSERR_NOERROR 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
MMSYSERR_INVALHANDLE
 지정된 디바이스 핸들이 잘못되었습니다.
MMSYSERR_NODRIVER
 디바이스 드라이버가 없습니다.
MMSYSERR_NOMEM
 메모리를 할당하거나 잠글 수 없습니다.
MMSYSERR_NOTSUPPORTED
 함수는 지원되지 않습니다.

설명

재생 속도를 변경해도 샘플 속도는 변경되지 않지만 재생 시간은 변경됩니다. 모든 디바이스가 재생 속도 변경을 지원하는 것은 아닙니다. 디바이스가 재생 속도 변경을 지원하는지 여부를 확인하려면 WAVECAPS_PLAYBACKRATE 플래그를 사용하여 WAVEOUTCAPS 구조체의 dwSupport 멤버(waveOutGetDevCaps 함수로 채워짐)를 테스트합니다.

요구 사항

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

추가 정보

파형 오디오

파형 함수