SYNTH_STATS-Struktur (dmusprop.h)
Die SYNTH_STATS-Struktur gibt Synthesizerleistungsstatistiken an, z. B. die Anzahl der wiedergegebenen Stimmen, die CPU-Auslastung, die Anzahl der verlorenen Notizen, die Menge des freien Arbeitsspeichers und die Spitzenlautstärke.
Syntax
typedef struct _SYNTH_STATS {
DWORD ValidStats;
DWORD Voices;
DWORD TotalCPU;
DWORD CPUPerVoice;
DWORD LostNotes;
DWORD FreeMemory;
LONG PeakVolume;
} SYNTH_STATS, *PSYNTH_STATS;
Member
ValidStats
Gibt an, welche Member der SYNTH_STATS-Struktur gültige Daten enthalten. Dieses Element ist ein Bitfeld, dessen Wert entweder null oder ein bitweises OR eines oder mehrerer der folgenden Flagbits ist:
SYNTH_STATS_VOICES
Das Feld Stimmen enthält gültige Daten.
SYNTH_STATS_TOTAL_CPU
Das Feld TotalCPU enthält gültige Daten.
SYNTH_STATS_CPU_PER_VOICE
Das Feld CPUPerVoice enthält gültige Daten.
SYNTH_STATS_LOST_NOTES
Das Feld LostNotes enthält gültige Daten.
SYNTH_STATS_PEAK_VOLUME
Das Feld PeakVolume enthält gültige Daten.
SYNTH_STATS_FREE_MEMORY
Das Feld FreeMemory enthält gültige Daten.
Voices
Gibt die durchschnittliche Anzahl der wiedergegebenen Stimmen an.
TotalCPU
Gibt die CPU-Gesamtauslastung (alle Stimmen) an, die als Prozentsatz (ein Mit 100 multiplizierter Anteil) ausgedrückt wird.
CPUPerVoice
Gibt die CPU-Auslastung pro Stimme an, die als Prozentsatz (ein Mit 100 multiplizierter Anteil) ausgedrückt wird.
LostNotes
Gibt die Anzahl der verlorenen Notizen an. Notizen können gelöscht werden, wenn die Anzahl gleichzeitiger Stimmen den von der KSPROPERTY_SYNTH_PORTPARAMETERS-Eigenschaft angegebenen Höchstwert überschreitet. Weitere Informationen finden Sie unter VoIP-Zuordnung.
FreeMemory
Gibt die Menge des freien Arbeitsspeichers in Bytes an. Dies ist der Speicher, der für das Herunterladen zusätzlicher DLS-Datenressourcen verfügbar bleibt.
PeakVolume
Gibt die Spitzenlautstärke an, ausgedrückt als Dezibel multipliziert mit 100.
Hinweise
Die KSPROPERTY_SYNTH_RUNNINGSTATS-Eigenschaft verwendet die SYNTH_STATS-Struktur, um einen DirectMusic-Miniporttreiber nach Statistiken zu einem Synthesizer abzufragen.
Die SYNTH_STATS-Struktur ähnelt der DMUS_SYNTHSTATS-Struktur, die in der Microsoft Windows SDK-Dokumentation beschrieben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dmusprop.h (include Dmusprop.h) |