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構造体のメンバーを指定します。 このメンバーは、値が 0 または次のフラグ ビットの 1 つ以上のビットごとの OR であるビットフィールドです。
SYNTH_STATS_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 プロパティは、シンセサイザーに関する統計情報の DirectMusic ミニポート ドライバーを照会するSYNTH_STATS構造体を使用します。
SYNTH_STATS構造は、Microsoft Windows SDK ドキュメントで説明されているDMUS_SYNTHSTATS構造に似ています。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | dmusprop.h (Dmusprop.h を含む) |