structure SYNTH_STATS (dmusprop.h)

  • Article

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)

Voir aussi

KSPROPERTY_SYNTH_PORTPARAMETERS

KSPROPERTY_SYNTH_RUNNINGSTATS