LOOPEDSTREAMING_POSITION_EVENT_DATA 구조체(ksmedia.h)

아티클
08/07/2023

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에 해당합니다.

루프 버퍼, 버퍼 위치 및 재생 및 레코드 커서에 대한 자세한 내용은 오디오 위치 속성을 참조하세요.