다음을 통해 공유


Waveform-Audio 기록 관리

[이 페이지와 연결된 기능인 Waveform Audio는 레거시 기능입니다. WASAPI오디오 그래프로 대체되었습니다. WASAPI오디오 그래프는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 파형 오디오 대신 WASAPI오디오 그래프를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

파형 오디오 입력 장치를 연 후 파형 오디오 데이터 기록을 시작할 수 있습니다. 웨이브 폼 오디오 데이터는 WAVEHDR 구조체에 지정된 애플리케이션 제공 버퍼에 기록됩니다. 이러한 데이터 블록을 사용하려면 먼저 준비해야 합니다. 자세한 내용은 오디오 데이터 블록을 참조하세요.

Windows는 파형 오디오 녹음을 관리하는 다음 함수를 제공합니다.

함수 설명
waveInAddBuffer 기록된 파형 오디오 데이터로 채울 수 있도록 버퍼를 디바이스 드라이버에 보냅니다.
waveInReset 파형 오디오 녹음을 중지하고 보류 중인 모든 버퍼를 완료된 대로 표시합니다.
waveInStart 파형 오디오 녹음을 시작합니다.
waveInStop 파형 오디오 녹음을 중지합니다.

 

waveInAddBuffer 함수를 사용하여 디바이스 드라이버에 버퍼를 보냅니다. 버퍼가 기록된 파형 오디오 데이터로 채워지면 디바이스를 열 때 지정된 플래그에 따라 창 메시지, 콜백 메시지, 스레드 메시지 또는 이벤트로 애플리케이션에 알림이 표시됩니다.

waveInStart를 사용하여 기록을 시작하기 전에 드라이버에 하나 이상의 버퍼를 보내거나 들어오는 데이터가 손실될 수 있습니다.

waveInClose를 사용하여 디바이스를 닫기 전에 waveInReset을 호출하여 보류 중인 데이터 블록을 완료된 것으로 표시합니다.

파형 오디오 녹음