struttura SYNTH_STATS (dmusprop.h)
La struttura SYNTH_STATS specifica le statistiche sulle prestazioni del sintetizzatore, ad esempio il numero di voci in riproduzione, l'utilizzo della CPU, il numero di note perse, la quantità di memoria libera e il massimo livello di volume.
Sintassi
typedef struct _SYNTH_STATS {
DWORD ValidStats;
DWORD Voices;
DWORD TotalCPU;
DWORD CPUPerVoice;
DWORD LostNotes;
DWORD FreeMemory;
LONG PeakVolume;
} SYNTH_STATS, *PSYNTH_STATS;
Membri
ValidStats
Specifica quali membri della struttura SYNTH_STATS contengono dati validi. Questo membro è un campo di bit il cui valore è zero o un OR bit per bit di uno o più dei bit di flag seguenti:
SYNTH_STATS_VOICES
Il campo voices contiene dati validi.
SYNTH_STATS_TOTAL_CPU
Il campo TotalCPU contiene dati validi.
SYNTH_STATS_CPU_PER_VOICE
Il campo CPUPerVoice contiene dati validi.
SYNTH_STATS_LOST_NOTES
Il campo LostNotes contiene dati validi.
SYNTH_STATS_PEAK_VOLUME
Il campo PeakVolume contiene dati validi.
SYNTH_STATS_FREE_MEMORY
Il campo freememory contiene dati validi.
Voices
Specifica il numero medio di voci riprodotte.
TotalCPU
Specifica l'utilizzo totale della CPU (tutte le voci), espresso come percentuale (una frazione moltiplicata per 100).
CPUPerVoice
Specifica l'utilizzo della CPU per voce, espresso come percentuale (una frazione moltiplicata per 100).
LostNotes
Specifica il numero di note perse. Le note possono essere eliminate se il numero di voci simultanee supera il valore massimo specificato dalla proprietà KSPROPERTY_SYNTH_PORTPARAMETERS. Per altre informazioni, vedere Allocazione vocale.
FreeMemory
Specifica la quantità di memoria libera in byte. Questa è l'archiviazione che rimane disponibile per il download di risorse di dati DLS aggiuntive.
PeakVolume
Specifica il livello di volume massimo espresso come decibel moltiplicato per 100.
Osservazioni
La proprietà KSPROPERTY_SYNTH_RUNNINGSTATS usa la struttura SYNTH_STATS per eseguire query su un driver miniport DirectMusic per ottenere statistiche su un sintetizzatore.
La struttura SYNTH_STATS è simile alla struttura DMUS_SYNTHSTATS, descritta nella documentazione di Microsoft Windows SDK.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | dmusprop.h (include Dmusprop.h) |