структура SYNTH_STATS (dmusprop.h)

  • Статья

Структура SYNTH_STATS определяет статистику производительности синтезатора, такую как количество воспроизводимых голосов, загрузка ЦП, количество потерянных заметок, объем свободной памяти и пиковый уровень громкости.

Синтаксис

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 содержат допустимые данные. Этот элемент представляет собой битовое поле, значение которого равно нулю или побитовой части ИЛИ одного или нескольких из следующих битов флага:

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

Указывает общую загрузку ЦП (все голоса), которая выражается в процентах (доля, умноженная на 100).

CPUPerVoice

Указывает загрузку ЦП на голос, которая выражается в процентах (доля, умноженная на 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