structure LOOPEDSTREAMING_POSITION_EVENT_DATA (ksmedia.h)

  • Article

La structure LOOPEDSTREAMING_POSITION_EVENT_DATA décrit un événement de position dans une mémoire tampon en boucle.

Syntaxe

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

Membres

KsEventData

Spécifie le type de notification que le système enverra au client lorsque l’événement se produit. Pour plus d’informations, consultez KSEVENTDATA.

Position

Spécifie la position de la mémoire tampon en tant que décalage d’octet à partir du début de la mémoire tampon bouclée. Si la taille de la mémoire tampon est de n octets, le membre Position doit contenir une valeur comprise entre 0 et n-1.

Remarques

L’événement KSEVENT_LOOPEDSTREAMING_POSITION utilise la structure LOOPEDSTREAMING_POSITION_EVENT_DATA. Ce type d’événement se produit uniquement dans les mémoires tampons en boucle. Une mémoire tampon en boucle est une mémoire tampon de données pour un flux audio de type KSINTERFACE_STANDARD_LOOPED_STREAMING.

Le pilote (généralement un composant système) qui génère l’événement compare le décalage d’octet dans le membre Position au curseur de lecture (dans un flux de rendu) ou au curseur d’enregistrement (dans un flux de capture). L’événement de position se produit lorsque le curseur de lecture ou d’enregistrement passe par la position spécifiée.

Lorsque le curseur de lecture ou d’enregistrement atteint la fin d’une mémoire tampon en boucle, le curseur s’enroule au début de la mémoire tampon, ce qui correspond à un décalage d’octet de 0.

Pour plus d’informations sur les mémoires tampons en boucle, les positions de mémoire tampon et les curseurs de lecture et d’enregistrement, consultez Audio Position Property.

Configuration requise

Condition requise Valeur
En-tête ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSEVENTDATA

KSEVENTSET_LoopedStreaming

KSEVENT_LOOPEDSTREAMING_POSITION

KSINTERFACE_STANDARD_LOOPED_STREAMING