LOOPEDSTREAMING_POSITION_EVENT_DATA結構 (ksmedia.h)

發行項
02/29/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 成員中的位元元移與轉譯數據流中的播放數據指標 ( (，或擷取) 數據流中的記錄數據指標 () 。當播放或記錄游標通過指定的位置時，就會發生 position 事件。

當播放或記錄數據指標到達迴圈緩衝區的結尾時，數據指標會包裝到緩衝區的開頭，其對應於0的位元組位移。

如需迴圈緩衝區、緩衝區位置及播放和錄製數據指標的詳細資訊，請參閱音訊位置屬性。