SYNTH_STATS結構 (dmusprop.h)
SYNTH_STATS結構會指定合成器效能統計數據,例如語音播放數目、CPU 使用量、筆記遺失數目、可用記憶體數量,以及尖峰音量層級。
語法
typedef struct _SYNTH_STATS {
DWORD ValidStats;
DWORD Voices;
DWORD TotalCPU;
DWORD CPUPerVoice;
DWORD LostNotes;
DWORD FreeMemory;
LONG PeakVolume;
} SYNTH_STATS, *PSYNTH_STATS;
成員
ValidStats
指定SYNTH_STATS結構的成員包含有效的數據。 這個成員是位欄位元,其值為零或位 OR 為下列一或多個旗標位:
SYNTH_STATS_VOICES
[Voices] 欄位包含有效的數據。
SYNTH_STATS_TOTAL_CPU
[TotalCPU] 字段包含有效的數據。
SYNTH_STATS_CPU_PER_VOICE
CPUPerVoice 欄位包含有效的數據。
SYNTH_STATS_LOST_NOTES
[LostNotes ] 字段包含有效的數據。
SYNTH_STATS_PEAK_VOLUME
PeakVolume 欄位包含有效的數據。
SYNTH_STATS_FREE_MEMORY
FreeMemory 欄位包含有效的數據。
Voices
指定播放語音的平均數目。
TotalCPU
指定 CPU 使用量總計(所有語音),以百分比表示(分數乘以 100)。
CPUPerVoice
指定每個語音的CPU使用量,以百分比表示(分數乘以100)。
LostNotes
指定遺失的筆記數目。 如果同時語音數目超過 KSPROPERTY_SYNTH_PORTPARAMETERS 屬性所指定的最大值,則可以卸除筆記。 如需詳細資訊,請參閱 語音設定。
FreeMemory
指定以位元組為單位的可用記憶體數量。 這是可供下載其他 DLS 數據資源的記憶體。
PeakVolume
指定以分貝表示的尖峰音量層級乘以 100。
言論
KSPROPERTY_SYNTH_RUNNINGSTATS 屬性會使用 SYNTH_STATS 結構來查詢 DirectMusic 迷你埠驅動程式,以取得合成器的相關統計數據。
SYNTH_STATS 結構類似於 DMUS_SYNTHSTATS 結構,如Microsoft Windows SDK 檔中所述。
要求
要求 | 價值 |
---|---|
標頭 | dmusprop.h (include Dmusprop.h) |