다음을 통해 공유


오디오 함수를 사용하여 오류 처리

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

파형 오디오 및 보조 오디오 함수는 오류가 발생할 때 0이 아닌 값을 반환합니다. Windows는 이러한 오류 값을 오류에 대한 텍스트 설명으로 변환하는 함수를 제공합니다. 애플리케이션은 계속 오류 값을 검사하여 진행 방법을 결정해야 하지만 오류에 대한 텍스트 설명은 사용자에게 오류를 설명하는 대화 상자에서 사용할 수 있습니다.

다음 함수를 사용하여 오디오 오류 값에 대한 텍스트 설명을 검색할 수 있습니다.

함수 설명
waveInGetErrorText 지정된 파형 오디오 입력 오류에 대한 텍스트 설명을 검색합니다.
waveOutGetErrorText 지정된 파형 오디오 출력 오류에 대한 텍스트 설명을 검색합니다.

 

오류 값을 반환하지 않는 유일한 오디오 함수는 auxGetNumDevs, waveInGetNumDevswaveOutGetNumDevs입니다. 이러한 함수는 시스템에 디바이스가 없거나 오류가 발생하는 경우 0을 반환합니다.