ksmedia.h) (LOOPEDSTREAMING_POSITION_EVENT_DATA 结构

项目
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 的字节偏移量。

有关循环缓冲区、缓冲区位置以及播放和录制光标的详细信息，请参阅音频位置属性。