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)

另請參閱

KSPROPERTY_SYNTH_PORTPARAMETERS

KSPROPERTY_SYNTH_RUNNINGSTATS