структура LOOPEDSTREAMING_POSITION_EVENT_DATA (ksmedia.h)

Статья
02/26/2024

Структура LOOPEDSTREAMING_POSITION_EVENT_DATA описывает событие положения в циклизованном буфере.

Синтаксис

typedef struct {
  KSEVENTDATA KsEventData;
#if ...
  ULONGLONG   Position;
#else
  DWORDLONG   Position;
#endif
} LOOPEDSTREAMING_POSITION_EVENT_DATA, *PLOOPEDSTREAMING_POSITION_EVENT_DATA;

Члены

KsEventData

Указывает тип уведомления, которое система будет отправлять клиенту при возникновении события. Дополнительные сведения см. в разделе KSEVENTDATA.

Position

Задает позицию буфера в виде смещения байтов от начала циклического буфера. Если размер буфера равен n байтов, элемент Position должен содержать значение в диапазоне от 0 до n–1.

Событие KSEVENT_LOOPEDSTREAMING_POSITION использует структуру LOOPEDSTREAMING_POSITION_EVENT_DATA. События этого типа происходят только в циклизированных буферах. Циклизированный буфер — это буфер данных для аудиопотока типа KSINTERFACE_STANDARD_LOOPED_STREAMING.

Драйвер (обычно системный компонент), создающий событие, сравнивает смещение байтов в элементе Position с курсором воспроизведения (в потоке отрисовки) или курсором записи (в потоке захвата). Событие положения возникает, когда курсор воспроизведения или записи проходит через указанную позицию.

Когда курсор воспроизведения или записи достигает конца зацикливаемого буфера, курсор перемещается в начало буфера, что соответствует смещению в байтах 0.

Дополнительные сведения о циклизуемых буферах, позициях буфера, а также о воспроизведении и записи курсоров см. в разделе Audio Position Property.