XAUDIO2_PERFORMANCE_DATA-Struktur (xaudio2.h)

Artikel
03/04/2024

Enthält Leistungsinformationen.

Syntax

typedef struct XAUDIO2_PERFORMANCE_DATA {
  UINT64 AudioCyclesSinceLastQuery;
  UINT64 TotalCyclesSinceLastQuery;
  UINT32 MinimumCyclesPerQuantum;
  UINT32 MaximumCyclesPerQuantum;
  UINT32 MemoryUsageInBytes;
  UINT32 CurrentLatencyInSamples;
  UINT32 GlitchesSinceEngineStarted;
  UINT32 ActiveSourceVoiceCount;
  UINT32 TotalSourceVoiceCount;
  UINT32 ActiveSubmixVoiceCount;
  UINT32 ActiveResamplerCount;
  UINT32 ActiveMatrixMixCount;
  UINT32 ActiveXmaSourceVoices;
  UINT32 ActiveXmaStreams;
} XAUDIO2_PERFORMANCE_DATA;

Member

AudioCyclesSinceLastQuery

CPU-Zyklen, die seit dem letzten Aufruf der IXAudio2::StartEngine - oder IXAudio2::GetPerformanceData-Funktion für die Audioverarbeitung aufgewendet wurden.

TotalCyclesSinceLastQuery

Die gesamte CPU-Zyklen, die seit dem letzten Aufruf verstrichen sind.

Hinweis Dies zählt nur Zyklen auf der CPU, auf der XAudio2 ausgeführt wird.

MinimumCyclesPerQuantum

Die wenigsten CPU-Zyklen, die seit dem letzten Aufruf für die Verarbeitung eines einzelnen Audio quantums aufgewendet wurden.

MaximumCyclesPerQuantum

Die meisten CPU-Zyklen, die seit dem letzten Aufruf für die Verarbeitung eines einzelnen Audioquns aufgewendet wurden.

MemoryUsageInBytes

Gesamtspeicher, der derzeit verwendet wird.

CurrentLatencyInSamples

Minimale Verzögerung zwischen dem Zeitpunkt, zu dem ein Beispiel aus einem Quellpuffer gelesen wird, und der Zeit, zu der es die Lautsprecher erreicht.

Windows
Die gemeldete Verzögerung ist ein Variablenwert, der dem groben Abstand zwischen der letzten Stichprobe, die von XAudio2 an den Treiber übermittelt wurde, und dem derzeit wiedergegebenen Beispiel entspricht. Die folgenden Faktoren können sich auf die Verzögerung auswirken: Wiedergabe von Mehrkanalaudio auf einem hardwarebeschleunigten Gerät; der Typ des Audiogeräts (WavePci, WaveCyclic oder WaveRT); und, in geringerem Umfang, Audiohardwareimplementierung.

Windows

Die gemeldete Verzögerung ist ein Variablenwert, der dem groben Abstand zwischen der letzten Stichprobe, die von XAudio2 an den Treiber übermittelt wurde, und dem derzeit wiedergegebenen Beispiel entspricht. Die folgenden Faktoren können sich auf die Verzögerung auswirken: Wiedergabe von Mehrkanalaudio auf einem hardwarebeschleunigten Gerät; der Typ des Audiogeräts (WavePci, WaveCyclic oder WaveRT); und, in geringerem Umfang, Audiohardwareimplementierung.

Xbox 360
Die gemeldete Verzögerung ist ein fester Wert, der normalerweise 1.024 Proben beträgt (21,333 ms bei 48 kHz). Wenn XOverrideSpeakerConfig mit dem flag XAUDIOSPEAKERCONFIG_LOW_LATENCY aufgerufen wurde, beträgt die gemeldete Verzögerung 512 Stichproben (10,667 ms bei 48 kHz).

GlitchesSinceEngineStarted

Gesamtanzahl der Audioausfälle seit dem Start der Engine.

ActiveSourceVoiceCount

Anzahl der aktuell wiedergegebenen Quellstimmtexte.

TotalSourceVoiceCount

Gesamtzahl der derzeit verfügbaren Quellstimmtexte.

ActiveSubmixVoiceCount

Anzahl der derzeit wiedergegebenen Submixstimmstimden.

ActiveResamplerCount

Anzahl der derzeit aktiven xAPOs für resampler.

ActiveMatrixMixCount

Anzahl der derzeit aktiven Matrixmix-xAPOs.

ActiveXmaSourceVoices

Windows
Nicht unterstützt.

Xbox 360
Anzahl der Quellstimme, die XMA-Daten decodieren.

ActiveXmaStreams

Windows
Nicht unterstützt.

Xbox 360
Eine Stimme kann mehrere XMA-Datenströme verwenden.

Hinweise

CPU-Zyklen werden mit aufgezeichnet. Verwenden Sie, um diese Werte zu konvertieren.

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Anforderungen

Anforderung	Wert
Header	xaudio2.h

Weitere Informationen

IXAudio2::GetPerformanceData

XAudio2-Strukturen