structure XAUDIO2_PERFORMANCE_DATA (xaudio2.h)

Article
03/06/2024

Contient des informations sur les performances.

Syntaxe

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;

Membres

AudioCyclesSinceLastQuery

Cycles d’UC consacrés au traitement audio depuis le dernier appel à la fonction IXAudio2 ::StartEngine ou IXAudio2 ::GetPerformanceData .

TotalCyclesSinceLastQuery

Nombre total de cycles d’UC écoulés depuis le dernier appel.

Note Cela ne compte que les cycles sur le processeur sur lequel XAudio2 s’exécute.

MinimumCyclesPerQuantum

Le plus petit nombre de cycles d’UC consacrés au traitement d’un quantum audio unique depuis le dernier appel.

MaximumCyclesPerQuantum

La plupart des cycles d’UC consacrés au traitement d’un quantum audio unique depuis le dernier appel.

MemoryUsageInBytes

Mémoire totale actuellement utilisée.

CurrentLatencyInSamples

Délai minimal qui se produit entre le moment où un exemple est lu à partir d’une mémoire tampon source et le moment où il atteint les haut-parleurs.

Windows
Le délai signalé est une valeur variable égale à la distance approximative entre le dernier échantillon envoyé au pilote par XAudio2 et l’exemple en cours de lecture. Les facteurs suivants peuvent affecter le délai : lecture de l’audio multicanal sur un appareil à accélération matérielle ; le type de périphérique audio (WavePci, WaveCyclic ou WaveRT) ; et, dans une moindre mesure, implémentation matérielle audio.

Windows

Le délai signalé est une valeur variable égale à la distance approximative entre le dernier échantillon envoyé au pilote par XAudio2 et l’exemple en cours de lecture. Les facteurs suivants peuvent affecter le délai : lecture de l’audio multicanal sur un appareil à accélération matérielle ; le type de périphérique audio (WavePci, WaveCyclic ou WaveRT) ; et, dans une moindre mesure, implémentation matérielle audio.

Xbox 360
Le délai signalé est une valeur fixe, qui est normalement de 1 024 échantillons (21,333 ms à 48 kHz). Si XOverrideSpeakerConfig a été appelé à l’aide de l’indicateur XAUDIOSPEAKERCONFIG_LOW_LATENCY , le délai signalé est de 512 exemples (10,667 ms à 48 kHz).

GlitchesSinceEngineStarted

Nombre total d’abandons audio depuis le démarrage du moteur.

ActiveSourceVoiceCount

Nombre de voix sources en cours de lecture.

TotalSourceVoiceCount

Nombre total de voix sources actuellement en cours d’existence.

ActiveSubmixVoiceCount

Nombre de voix de sous-mixage en cours de lecture.

ActiveResamplerCount

Nombre d’objets xAP de rééchantillonnage actuellement actifs.

ActiveMatrixMixCount

Nombre de xAPOs de combinaison de matrices actuellement actifs.

ActiveXmaSourceVoices

Windows
Non prise en charge.

Xbox 360
Nombre de voix sources décodant des données XMA.

ActiveXmaStreams

Windows
Non prise en charge.

Xbox 360
Une voix peut utiliser plusieurs flux XMA.

Remarques

Les cycles processeur sont enregistrés à l’aide de . Utilisez pour convertir ces valeurs.

Configuration requise pour la plateforme

Windows 10 (XAudio2.9) ; Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Configuration requise

Condition requise	Valeur
En-tête	xaudio2.h

Voir aussi

IXAudio2 ::GetPerformanceData

XAudio2 Structures

Partager via