SYNTH_STATS Struktur (dmusprop.h)
Die SYNTH_STATS Struktur gibt Synthetizerleistungsstatistiken an, z. B. die Anzahl der Wiedergegebenen Stimmen, die CPU-Auslastung, die Anzahl der verloren gegangenen Notizen, die Menge an freiem Arbeitsspeicher 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;
Angehörige
ValidStats
Gibt an, welche Elemente der SYNTH_STATS Struktur gültige Daten enthalten. Dieses Element ist ein Bitfeld, dessen Wert entweder null oder ein bitweiser ODER 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 CPUPerVoice Feld 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 gesamte CPU-Auslastung (alle Stimmen) an, die als Prozentsatz ausgedrückt wird (ein Bruchteil multipliziert mit 100).
CPUPerVoice
Gibt die CPU-Auslastung pro Stimme an, die als Prozentsatz ausgedrückt wird (ein Bruchteil multipliziert mit 100).
LostNotes
Gibt die Anzahl der verloren gegangenen Notizen an. Notizen können gelöscht werden, wenn die Anzahl gleichzeitiger Stimmen den von der eigenschaft KSPROPERTY_SYNTH_PORTPARAMETERS angegebenen Höchstwert überschreitet. Weitere Informationen finden Sie unter Voice Allocation.
FreeMemory
Gibt die Menge an freiem Arbeitsspeicher in Byte an. Dies ist der Speicher, der zum Herunterladen zusätzlicher DLS-Datenressourcen verfügbar bleibt.
PeakVolume
Gibt die Höchstlautstärke an, ausgedrückt als Dezibel multipliziert mit 100.
Bemerkungen
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) |