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
[語音] 欄位包含有效的資料。
SYNTH_STATS_TOTAL_CPU
[總計CPU] 欄位包含有效的數據。
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 (包含 Dmusprop.h) |