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 を含む)

こちらもご覧ください

KSPROPERTY_SYNTH_PORTPARAMETERS

KSPROPERTY_SYNTH_RUNNINGSTATS