KSPROPERTY_STREAM_RATE
KSPROPERTY_STREAM_RATE プロパティは、KSPROPERTY_STREAM_RATECAPABILITY と組み合わせて機能し、ピンの機能を照会した後にセグメントのレートを設定するときに使用します。
使用方法概要表
取得 | 設定 | 対象 | プロパティ記述子の種類 | プロパティ値の種類 |
---|---|---|---|---|
はい |
はい |
ピン |
備考
KSPROPERTY_STREAM_RATE は、ピンでレートの変更が許可されている場合、またはトポロジ関連のピン間のインターフェイスが異なっているために異なるタイム スタンプ形式が使用される場合に実装する必要があります。
このプロパティは、要求されたレートを標準レート 1.0 に近づけることができるように、リサンプリングまたはタイム スタンプの変更によってデータのレートを変更できるピンでサポートされています。
プロパティを読み取り、現在のレートとセグメントを返します。 新しいセグメントのレートを設定すると、現在のレート設定が置き換えられます。 この方法では、高速転送要求を停止するには、常に受け入れる必要がある 1.0 のレート設定を要求します。 指定したレートが取得できない場合、ピンは最適な設定を試みるのではなく、要求を拒否できます。
レート設定とクエリの両方で、プレゼンテーションの開始、期間、およびレートを指定する KSRATE 構造体が使用されます。 レートの変更は、一時停止状態または実行状態でのみ実行でき、他の状態に変更した後に停止されます。 レートの変更は、ピンが調整する標準レート 1.0 以上または以下の割合で指定され、現在の設定は同じ形式で返されます。
このプロパティは、前のプロパティで指定されたインターフェイスと時間単位を変換するためにも使用する必要があります。また、レート変更がサポートされていない場合でも、ピン間のインターフェイスを変更するフィルターに実装する必要があります。 たとえば、あるピンで KSINTERFACE_STANDARD_POSITION をサポートし、トポロジに関連する別のピンの KSINTERFACE_STANDARD_STREAMING に変換するフィルターでは、レート変更がサポートされない場合があります。 フィルターは、ピンといずれかのインターフェイスで変更要求を受け取り、独自のインターフェイスとユニットに変更できる必要がありますが、レートは変更されません。
ピンでクロックも生成される場合は、レートの一致にクロックを使用するクライアントは、基になるハードウェアが標準レート 1.0 で実行されているかのように傾きが予想されるため、レート変更によって物理的な時間の傾きを変更することはできません。 つまり、大幅なドリフトなしに物理的なクロック傾きが一貫していることを保証できないピンは、レート調整要求を受け入れることができません。
要件
ヘッダー |
Ks.h (Ks.h を含む) |