estrutura LOOPEDSTREAMING_POSITION_EVENT_DATA (ksmedia.h)

Artigo
03/01/2024

A estrutura LOOPEDSTREAMING_POSITION_EVENT_DATA descreve um evento de posição em um buffer em loop.

Sintaxe

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

Membros

KsEventData

Especifica o tipo de notificação que o sistema enviará ao cliente quando o evento ocorrer. Para obter mais informações, consulte KSEVENTDATA.

Position

Especifica a posição do buffer como um deslocamento de bytes do início do buffer em loop. Se o tamanho do buffer for n bytes, o membro Position deverá conter um valor no intervalo de 0 a n-1.

Comentários

O evento KSEVENT_LOOPEDSTREAMING_POSITION usa a estrutura LOOPEDSTREAMING_POSITION_EVENT_DATA. Esse tipo de evento ocorre apenas em buffers em loop. Um buffer em loop é um buffer de dados para um fluxo de áudio do tipo KSINTERFACE_STANDARD_LOOPED_STREAMING.

O driver (normalmente um componente do sistema) que gera o evento compara o deslocamento de bytes no membro Position com o cursor de reprodução (em um fluxo de renderização) ou o cursor de registro (em um fluxo de captura). O evento position ocorre quando o cursor de reprodução ou registro passa pela posição especificada.

Quando o cursor de reprodução ou registro atinge o final de um buffer em loop, o cursor é encapsulado até o início do buffer, que corresponde a um deslocamento de bytes de 0.

Para obter mais informações sobre buffers em loop, posições de buffer e cursores de reprodução e gravação, consulte Propriedade Audio Position.