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
割合 (100 を乗算した分数) で表される、音声あたりの CPU 使用率を指定します。
LostNotes
失われたノートの数を指定します。 同時音声の数が 、KSPROPERTY_SYNTH_PORTPARAMETERS プロパティで指定された最大数を超えると、ノートを削除できます。 詳細については、「 音声割り当て」を参照してください。
FreeMemory
空きメモリの量をバイト単位で指定します。 これは、追加の DLS データ リソースをダウンロードするために引き続き使用できるストレージです。
PeakVolume
デシベルに 100 を乗算して表されるピーク ボリューム レベルを指定します。
注釈
KSPROPERTY_SYNTH_RUNNINGSTATS プロパティは、SYNTH_STATS構造体を使用して DirectMusic ミニポート ドライバーに対してシンセサイザーに関する統計情報を照会します。
SYNTH_STATS構造体は、Microsoft Windows SDKドキュメントで説明されているDMUS_SYNTHSTATS構造に似ています。
要件
| 要件 | 値 |
|---|---|
| Header | dmusprop.h (Dmusprop.h を含む) |