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

Статья
02/06/2025

Структура 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, описанной в документации по пакету SDK для Microsoft Windows.

Требования

Требование	Ценность
заголовка	dmusprop.h (include Dmusprop.h)

См. также

KSPROPERTY_SYNTH_PORTPARAMETERS

KSPROPERTY_SYNTH_RUNNINGSTATS

Поделиться через