structure SYNTH_STATS (dmusprop.h)
La structure SYNTH_STATS spécifie des statistiques de performances du synthétiseur, telles que le nombre de voix lues, l’utilisation du processeur, le nombre de notes perdues, la quantité de mémoire libre et le niveau de volume maximal.
Syntaxe
typedef struct _SYNTH_STATS {
DWORD ValidStats;
DWORD Voices;
DWORD TotalCPU;
DWORD CPUPerVoice;
DWORD LostNotes;
DWORD FreeMemory;
LONG PeakVolume;
} SYNTH_STATS, *PSYNTH_STATS;
Membres
ValidStats
Spécifie les membres de la structure SYNTH_STATS qui contiennent des données valides. Ce membre est un champ de bits dont la valeur est égale à zéro ou au niveau du bit OU d’un ou plusieurs des bits d’indicateur suivants :
SYNTH_STATS_VOICES
Le champ Voix contient des données valides.
SYNTH_STATS_TOTAL_CPU
Le champ TotalCPU contient des données valides.
SYNTH_STATS_CPU_PER_VOICE
Le champ CPUPerVoice contient des données valides.
SYNTH_STATS_LOST_NOTES
Le champ LostNotes contient des données valides .
SYNTH_STATS_PEAK_VOLUME
Le champ PeakVolume contient des données valides.
SYNTH_STATS_FREE_MEMORY
Le champ FreeMemory contient des données valides.
Voices
Spécifie le nombre moyen de voix lues.
TotalCPU
Spécifie l’utilisation totale du processeur (toutes les voix), qui est exprimée en pourcentage (une fraction multipliée par 100).
CPUPerVoice
Spécifie l’utilisation du processeur par voix, qui est exprimée en pourcentage (une fraction multipliée par 100).
LostNotes
Spécifie le nombre de notes perdues. Les notes peuvent être supprimées si le nombre de voix simultanées dépasse le nombre maximal spécifié par la propriété KSPROPERTY_SYNTH_PORTPARAMETERS . Pour plus d’informations, consultez Allocation de voix.
FreeMemory
Spécifie la quantité de mémoire libre en octets. Il s’agit du stockage qui reste disponible pour le téléchargement de ressources de données DLS supplémentaires.
PeakVolume
Spécifie le niveau de volume maximal exprimé en décibels multipliés par 100.
Remarques
La propriété KSPROPERTY_SYNTH_RUNNINGSTATS utilise la structure SYNTH_STATS pour interroger un pilote miniport DirectMusic pour obtenir des statistiques sur un synthétiseur.
La structure SYNTH_STATS est similaire à la structure DMUS_SYNTHSTATS, qui est décrite dans la documentation Microsoft Windows SDK.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dmusprop.h (inclure Dmusprop.h) |