перечисление KSPROPERTY_MIDILOOPEDSTREAMING (ksmedia.h)

Перечисление KSPROPERTY_MIDILOOPEDSTREAMING определяет свойства, доступные для операций потоковой передачи MIDI с низкой задержкой и высокой производительностью потоковой передачи данных MIDI.

Синтаксис

typedef enum {
  KSPROPERTY_MIDILOOPEDSTREAMING_BUFFER,
  KSPROPERTY_MIDILOOPEDSTREAMING_REGISTERS,
  KSPROPERTY_MIDILOOPEDSTREAMING_NOTIFICATION_EVENT
} KSPROPERTY_MIDILOOPEDSTREAMING;

Constants

 
KSPROPERTY_MIDILOOPEDSTREAMING_BUFFER
Указывает свойство, используемое для получения сведений о циклизованном буфере потоковой передачи. Это свойство возвращает KSMIDILOOPED_BUFFER структуру, содержащую адрес буфера и размер. Запрос свойства использует структуру KSMIDILOOPED_BUFFER_PROPERTY для указания запрошенного размера буфера.
KSPROPERTY_MIDILOOPEDSTREAMING_REGISTERS
Указывает свойство, используемое для извлечения указателей на регистры позиций чтения и записи для буфера потоковой передачи. Это свойство возвращает KSMIDILOOPED_REGISTERS структуру, содержащую указатели на регистры позиции, отслеживающие текущие позиции чтения и записи в циклический буфер.
KSPROPERTY_MIDILOOPEDSTREAMING_NOTIFICATION_EVENT
Указывает свойство, используемое для задания дескрипторов событий для уведомлений во время цикловых операций потоковой передачи. Это свойство принимает KSMIDILOOPED_EVENT структуру, содержащую дескриптор событий, которые будут сигнализировать при завершении операций чтения или записи.

Замечания

Набор свойств KSPROPSETID_MidiLoopedStreaming использует эти значения перечисления для определения определенных свойств, связанных с операциями потоковой передачи с циклом MIDI. Циклическая потоковая передача предоставляет механизм для обработки данных MIDI с низкой задержкой путем создания циклического буфера, совместно используемого драйвером и клиентским приложением.

Типичная последовательность настройки циклизированной потоковой передачи:

  1. Использование KSPROPERTY_MIDILOOPEDSTREAMING_BUFFER для выделения и извлечения сведений о буфере
  2. Использование KSPROPERTY_MIDILOOPEDSTREAMING_REGISTERS для получения доступа к регистрам отслеживания позиций
  3. Настройка уведомлений на основе событий с помощью KSPROPERTY_MIDILOOPEDSTREAMING_NOTIFICATION_EVENT

Этот механизм позволяет высокопроизводительным приложениям MIDI достичь очень низкой задержки, предоставляя прямой доступ к буферу потоковой передачи и регистрам позиций.

Требования

Требование Ценность
Header ksmedia.h (include Ksmedia.h)

См. также

  • Last updated on