LOOPEDSTREAMING_POSITION_EVENT_DATA-Struktur (ksmedia.h)

Artikel
02/26/2024

Die LOOPEDSTREAMING_POSITION_EVENT_DATA-Struktur beschreibt ein Positionsereignis in einem Schleifenpuffer.

Syntax

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

Member

KsEventData

Gibt den Typ der Benachrichtigung an, die das System an den Client sendet, wenn das Ereignis eintritt. Weitere Informationen finden Sie unter KSEVENTDATA.

Position

Gibt die Pufferposition als Byteoffset vom Anfang des Schleifenpuffers an. Wenn die Größe des Puffers n Bytes ist, muss das Element Position einen Wert im Bereich 0 bis n-1 enthalten.

Hinweise

Das KSEVENT_LOOPEDSTREAMING_POSITION-Ereignis verwendet die LOOPEDSTREAMING_POSITION_EVENT_DATA-Struktur. Dieser Ereignistyp tritt nur in Schleifenpuffern auf. Ein Schleifenpuffer ist ein Datenpuffer für einen Audiostream vom Typ KSINTERFACE_STANDARD_LOOPED_STREAMING.

Der Treiber (in der Regel eine Systemkomponente), der das Ereignis generiert, vergleicht den Byteoffset im Position-Element mit dem Wiedergabecursor (in einem Renderingstream) oder dem Datensatzcursor (in einem Aufzeichnungsstream). Das Positionsereignis tritt auf, wenn der Wiedergabe- oder Datensatzcursor die angegebene Position durchläuft.

Wenn der Wiedergabe- oder Datensatzcursor das Ende eines Schleifenpuffers erreicht, umschließt sich der Cursor bis zum Anfang des Puffers, was einem Byteoffset von 0 entspricht.

Weitere Informationen zu Pufferschleifen, Pufferpositionen sowie Wiedergabe- und Aufzeichnungscursors finden Sie unter Audiopositionseigenschaft.