IXAudio2EngineCallback::OnCriticalError 메서드(xaudio2.h)

XAudio2를 종료하고 다시 시작해야 하는 중요한 시스템 오류가 발생하는 경우 호출됩니다.

구문

void OnCriticalError(
  HRESULT Error
);

매개 변수

Error

XAudio2에서 반환된 오류 코드입니다.

반환 값

없음

설명

szDeviceId 매개 변수에서 특정 디바이스의 ID를 IXAudio2::CreateMasteringVoice에 제공하거나 XAUDIO2_NO_VIRTUAL_AUDIO_CLIENT 플래그를 사용하면 심각한 오류가 발생하고 기본 WASAPI 렌더링 디바이스를 사용할 수 없게 되면 OnCriticalError가 발생합니다. 예를 들어 헤드셋이나 스피커가 분리되거나 USB 오디오 장치가 제거될 때 발생할 수 있습니다. 심각한 오류가 발생하면 오디오 처리가 중지되고 XAudio2에 대한 모든 추가 호출이 실패합니다. 이 상황에서 복구하는 유일한 방법은 XAudio2 instance 릴리스하고 새 XAudio2를 만드는 것입니다.

NULL 또는 szDeviceId 매개 변수를 IXAudio2::CreateMasteringVoice로 지정한 경우 시스템은 가상 오디오 클라이언트를 사용하여 오디오 엔드포인트를 나타냅니다. 이 경우 기본 WASAPI 렌더링 디바이스를 사용할 수 없게 되면 시스템에서 렌더링을 위해 새 오디오 렌더링 디바이스를 자동으로 선택하고, 오디오 처리를 계속하며, OnCriticalError 가 발생하지 않습니다.

모바일 디바이스 패밀리에서 Virtual Audio 클라이언트는 항상 사용되며, CreateMasteringVoice에 제공하는 값에 관계없이 OnCriticalError는 발생하지 않습니다.

IXAudio2EngineCallback 인터페이스 메서드에 대한 자세한 내용은 XAudio2 콜백 섹션을 참조하세요.

플랫폼 요구 사항

요구 사항

참고 항목

IXAudio2EngineCallback

XAudio2 콜백