次の方法で共有


KSPROPERTY_STREAM_RATECAPABILITY

KSPROPERTY_STREAM_RATECAPABILITY プロパティを使用すると、グラフ マネージャーは、特定のストリームのフローに関係するすべての接続ポイント (KSPROPERTY_PIN_DATAROUTING を介して取得) に対して、要求されたレートを標準レートに調整する機能についてクエリを実行できます。

使用方法概要表

取得 設定 対象 プロパティ記述子の種類 プロパティ値の種類

はい

いいえ

ピン

KSRATE

KSRATE_CAPABILITY

備考

KSPROPERTY_STREAM_RATECAPABILITY は、ピンでレートの変更が許可されている場合、またはトポロジ関連のピン間のインターフェイスが異なっているために異なるタイム スタンプ形式が使用される場合に実装する必要があります。 このプロパティは、スキップのデグラデーション要求など、一般的なタイム スタンプ形式の変換にも使用できます。

プロパティは、リサンプリングまたはタイム スタンプの変更によってデータのレートを変更するピンでサポートされています。 すべてのレート変更には、レートを要求し、特定のピンがそのレートを修正して標準レート 1.0 を取得できる量を判断する必要があります。 たとえば、ビデオ再生レート 2.0 を要求するピンは、ビデオ クリップの標準レートの 2 倍でレンダリングする要求を意味します。0.5 のレート要求は、半分の速度レンダリングを意味します。

レート要求には、プレゼンテーションの開始時刻とそのレート要求の期間の両方が含まれます。 これにより、データ ストリームの特定の部分に適用される可能性がある制約を考慮できます。 プレゼンテーション時刻、分子/分母ペア、および期間単位は、構造体で指定されたインターフェイスの観点から表されます。 標準インターフェイスを使用しない場合、初期レート変更クエリをピンに送信することはできません。

ピンは、同様のトポロジを持つ任意のピンで使用されるインターフェイス識別子を受け入れることができる必要があります。 また、インターフェイス識別子と時間単位を独自の対応する値に変換する必要があります。 この方法では、クライアントは既知の 1 つのインターフェイス ポイントからグラフを走査し、各ステップで接続ポイントによって単位を変換できます。

レートを変更できない場合でもインターフェイスの変更が行われる場合は、このプロパティをサポートすることが重要です。そのため、クエリの実行時にインターフェイスと時間の単位を調整できます。 結果は返されるレートを変更しませんが、Interface、PresentationStart、および Duration を変更します。

レート機能要求は、一時停止状態または実行状態でのみ実行でき、他の状態に変更した後は無効になります。 レートが最初は 1.0 であるクエリは、通常はタイム スタンプ形式を変換する要求に過ぎず、常に成功する必要があります。

要件

ヘッダー

Ks.h (Ks.h を含む)

関連項目

KSRATE

KSRATE_CAPABILITY