Udostępnij za pośrednictwem

Narzędzia debugowania XAudio2

  • Artykuł

Wersja debugowania aparatu XAudio2 weryfikuje parametry i udostępnia szczegółowe komunikaty ostrzegawcze i komunikaty o błędach.

Ustawianie poziomu rejestrowania debugowania podczas działania

Poziom informacji debugowania wyświetlanych przez XAudio2 można ustawić w dowolnym momencie, wypełniając strukturę XAUDIO2_DEBUG_CONFIGURATION flagami określającymi żądany poziom szczegółowości logowania, a następnie przekazując tę strukturę do metody IXAudio2::SetDebugConfiguration. Wartości przekazywane do metody "IXAudio2::SetDebugConfiguration" zawsze nadpisują wszelkie wartości domyślne, które zostały ustawione w rejestrze systemu Windows.

Obsługa debugowania

Narzędzia debugowania są zawsze dostępne dla XAUDIO2 w systemie Windows 8.x, Windows 10, Windows 11 i w przypadku korzystania z pakietu XAudio2Redist.

W przypadku starszych wersji zestawu SDK DirectX XAUDIO2 należy użyć XAUDIO2_DEBUG_ENGINE podczas tworzenia obiektu XAUDIO2 z XAudio2Create, i system musi mieć zainstalowaną wersję deweloperską środowiska wykonawczego SDK DirectX w celu debugowania.

Włączanie śledzenia zdarzeń dla systemu Windows (ETW) dla XAudio2

W przypadku programu XAudio 2.8 lub nowszego wszystkie informacje debugowania są rejestrowane za pośrednictwem funkcji ETW. Aby włączyć rejestrowanie tych zdarzeń, wykonaj następujące kroki:

  1. Wyszukaj ciąg "Podgląd zdarzeń" w systemie lokalnym i uruchom tę aplikację.
  2. Wybierz pozycję Widok na pasku menu i ustaw znacznik wyboru na Pokaż dzienniki analityczne i debugowania.
  3. Korzystając z widoku drzewa, wybierz pozycję Dzienniki aplikacji i usług / Microsoft / Windows / XAudio2.
  4. Kliknij prawym przyciskiem myszy na rejestrowanie debugowania Microsoft Windows XAudio2 i wybierz "Właściwości".
  5. Kliknij pole wyboru "Włącz dziennik" i naciśnij przycisk "OK". Opcjonalnie możesz zmienić lokalizację dziennika, która ma wartość domyślną %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl.

Uruchom scenariusze w zwykły sposób, a gdy chcesz zobaczyć ostatnie działanie, otwórz plik dziennika ETL i poszukaj zdarzeń. Istnieje wiele narzędzi, których można użyć, w tym Podgląd zdarzeń za pomocą polecenia "Otwórz zapisany dziennik..." w okienku akcji.

Aby uzyskać więcej informacji, zobacz Śledzenie Zdarzeń .

Funkcje debugowania

Referencja programistyczna XAudio2