KSPROPERTY_RTAUDIO_PRESENTATION_POSITION

KSPROPERTY_RTAUDIO_PRESENTATION_POSITION は、ストリーム プレゼンテーション情報を返します。

用法の要点テーブル

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
はい	いいえ	ピン留めする	KSPROPERTY	KSAUDIO_PRESENTATION_POSITION

プロパティ記述子 (インスタンス データ) は KSPROPERTY 構造体です。 要求を送信する前に、クライアントは、オーディオ データ ストリーム内の現在のカーソル位置を示す値を持つ構造体を読み込みます。

プロパティ値は、KSAUDIO_PRESENTATION_POSITION 構造体です。これは、オーディオ データ ストリーム内の最新のプレゼンテーション位置を示します。

戻り値

KSPROPERTY_RTAUDIO_PRESENTATION_POSITION プロパティ要求は、正常に完了したことを示すために STATUS_SUCCESS を返します。 それ以外の場合、要求は適切な失敗状態コードを返します。

解説

OS は、ドライバーからこのプロパティを定期的に取得して、上位レイヤーがビデオやその他のアクティビティをオーディオ ストリームと同期できるように、ドライバーから最近のプレゼンテーションの位置情報を取得する場合があります。

KSAUDIO_PRESENTATION_POSITION の u64PositionInBlocks メンバーで返される値は、KSPROPERTY_RTAUDIO_PACKETCOUNT が返すパケット数と SetWritePacket に渡すパケット数のドライバーの解釈と一貫している必要があります。 つまり、パケット 0 の最初のサンプルはブロック 0 です。

これは、KSPROPERTY_RTAUDIO_PACKETCOUNT と KSPROPERTY_RTAUDIO_PRESENTATION_POSITION が同時に呼び出されると、同じサンプルを参照する値を返すという意味ではありません。 KSPROPERTY_RTAUDIO_PACKETCOUNT は WaveRT バッファーからハードウェアに転送されたサンプルに関する情報を返し、KSPROPERTY_RTAUDIO_PRESENTATION_POSITION はシステムの出力で提示されたサンプルに関する情報を返します。 これらは 2 つの異なる情報です。

要件

バージョン	Windows 10 以降の Windows オペレーティング システムで使用できます。
ヘッダー	Ksmedia.h

関連項目

KSPROPSETID_RTAudio