LOOPEDSTREAMING_POSITION_EVENT_DATA 構造体 (ksmedia.h)

[アーティクル]
02/26/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 のバイトオフセットに対応します。

ループされたバッファー、バッファー位置、および再生カーソルとレコードカーソルの詳細については、「 Audio Position プロパティ」を参照してください。