XAudio2 디버깅 기능

XAudio2 엔진의 디버그 버전은 매개 변수의 유효성을 검사하고 자세한 경고 및 오류 메시지를 제공합니다.

런타임에 디버그 로깅 수준 설정

원하는 로깅 수준에 대한 플래그로 XAUDIO2_DEBUG_CONFIGURATION 구조체를 입력하여 언제든지 XAudio2에 표시되는 디버깅 정보 수준을 설정한 다음 IXAudio2::SetDebugConfiguration 메서드에 구조를 전달할 수 있습니다. IXAudio2::SetDebugConfiguration 메서드에 전달된 값은 항상 Windows 레지스트리에 설정된 모든 기본값을 재정의합니다.

디버그 지원

디버깅 기능은 Windows 8.x, Windows 10, Windows 11 및 XAudio2Redist 패키지를 사용하는 경우 XAUDIO2에 항상 사용할 수 있습니다.

XAUDIO2의 레거시 DirectX SDK 버전의 경우 XAudio2Create를 사용하여 XAUDIO2 개체를 만들 때 XAUDIO2_DEBUG_ENGINE 사용해야 하며, 디버깅을 지원하려면 시스템에 DirectX SDK 개발자 런타임이 설치되어 있어야 합니다.

XAudio2용 ETW(Windows용 이벤트 추적) 사용

XAudio 2.8 이상을 사용하면 모든 디버깅 정보가 ETW를 통해 기록됩니다. 이러한 이벤트의 로깅을 사용하도록 설정하려면 다음 단계를 사용합니다.

1. 로컬 시스템에서 "이벤트 뷰어"를 검색하고 이 애플리케이션을 실행합니다.
2. 메뉴 모음에서 보기를 선택하고 분석 및 디버그 로그 표시에서 검사 표시를 설정합니다.
3. 트리 뷰를 사용하여 애플리케이션 및 서비스 로그 / Microsoft / Windows / XAudio2를 선택합니다.
4. Microsoft Windows XAudio2 디버그 로깅을 마우스 오른쪽 단추로 클릭하고 "속성"을 선택합니다.
5. "로그 사용"에서 검사 상자를 클릭하고 "확인"을 누릅니다. 필요에 따라 로 기본값인 로그 위치를 변경할 수 있습니다 %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl.

시나리오를 정상적으로 실행하고 최근 활동을 보려면 ETL 로그 파일을 열고 이벤트를 찾습니다. "저장된 로그 열기..."를 통한 이벤트 뷰어 포함하여 사용할 수 있는 다양한 도구가 있습니다. 작업 창에 있습니다.

자세한 내용은 이벤트 추적을 참조하세요.

관련 항목

디버깅 기능

XAudio2 프로그래밍 참조