struttura SYNTH_STATS (dmusprop.h)
La struttura SYNTH_STATS specifica le statistiche delle 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 livello di volume di picco.
Sintassi
typedef struct _SYNTH_STATS {
DWORD ValidStats;
DWORD Voices;
DWORD TotalCPU;
DWORD CPUPerVoice;
DWORD LostNotes;
DWORD FreeMemory;
LONG PeakVolume;
} SYNTH_STATS, *PSYNTH_STATS;
Members
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 del flag seguenti:
SYNTH_STATS_VOICES
Il campo Voci 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 (frazione moltiplicata per 100).
CPUPerVoice
Specifica l'utilizzo della CPU per voce, espresso come percentuale (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. Si tratta dell'archiviazione che rimane disponibile per il download di risorse dati DLS aggiuntive.
PeakVolume
Specifica il livello di volume massimo espresso come decibel moltiplicato per 100.
Commenti
La proprietà KSPROPERTY_SYNTH_RUNNINGSTATS usa la struttura SYNTH_STATS per eseguire una query su un driver miniport DirectMusic per ottenere statistiche su un sintetizzatore.
La struttura SYNTH_STATS è simile alla struttura DMUS_SYNTHSTATS, descritta nella documentazione Microsoft Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | dmusprop.h (include Dmusprop.h) |