KsPinGetTrailingEdgeStreamPointer 関数 (ks.h)

[アーティクル]
08/07/2023

KsPinGetTrailingEdgeStreamPointer 関数は、指定されたピンに関連付けられているキューの末尾のエッジストリームポインターを取得します。

構文

KSDDKAPI PKSSTREAM_POINTER KsPinGetTrailingEdgeStreamPointer(
  [in] PKSPIN                 Pin,
  [in] KSSTREAM_POINTER_STATE State
);

パラメーター

[in] Pin

末尾のエッジストリームポインターを返すキューを持つ KSPIN 構造体へのポインター。

[in] State

このパラメーターは、末尾のエッジストリームポインターを取得する状態を指定します。以下のいずれかを指定できます。

KSSTREAM_POINTER_STATE_UNLOCKED

データフレームを参照するかどうかに関係なく、リーディングエッジストリームポインターを取得します。

ポインターがロックされるまで、ポインターに関連付けられているデータへのアクセスは試行できません。また、ロック解除されたストリームポインターに関連付けられているフレームを取り消すこともできます。

KSSTREAM_POINTER_STATE_LOCKED

リーディングエッジストリームポインターを取得してロックします。ストリームポインターに関連付けられているデータフレームがない場合は、 NULL を返します。 null 以外のポインターが返された場合は、ロックされたストリームポインターであり、データフレームが関連付けられます。ロックされたストリームポインターに関連付けられているフレームを取り消 すことはできません 。

戻り値

KsPinGetTrailingEdgeStreamPointer は 、末尾のエッジストリームポインターを表す KSSTREAM_POINTER 構造体へのポインターまたは NULL を返します。 NULL の戻り値は、ピンに関連付けられているキューの末尾の端がないことを示すことができます。この場合、ピン記述子では、ピンが個別の末尾エッジを持つ必要があることを指定していない可能性があります。または、 NULL は 、ピンに関連付けられているキューがないことを示すことができます。この場合、問題のピンは標準のトランスポートメカニズムを使用しません。 NULL の戻り値は、末尾のエッジをロックしようとして失敗したことを示すこともできます。つまり、現在、リーディングエッジに関連付けられているデータフレームはありません。

注釈

末尾のエッジストリームポインターは、ピンのピン記述子が個別の末尾エッジを指定している場合にのみ存在するデータストリームへの特別なポインターです。このポインターが存在する場合は、KsStreamPointerAdvance Xxx または KsStreamPointerUnlock 呼び出しによって特に高度でない限り、キュー内の最も古いデータを指します。また、末尾のエッジが指すフレームより古いフレームに対して複製されたストリームポインターが存在する場合も、古いデータがキューに存在する可能性があります。

先頭エッジストリームポインターと末尾エッジストリームポインターの間のウィンドウに存在するデータフレームは、少なくとも 1 つの参照カウントを持つため、末尾のエッジの進歩の結果としてウィンドウを終了するまで、キューから離れて完了しません。先行エッジと末尾エッジの間のフレームは既定ではロック されないため 、取り消すことができます。

KsPinGetTrailingEdgeStreamPointer は、ほとんどの場合、ピン中心のフィルターで使用されます。詳細については、「ピン中心の処理」と「フィルター中心の処理」を参照してください。

KsPinGetTrailingEdgeStreamPointer は、キューが KSPIN_FLAG_DISTINCT_TRAILING_EDGE フラグを設定して個別の末尾エッジを持つ必要があることをピンのピン記述子で指定しない限り、機能しません。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows XP 以降のオペレーティングシステムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム	ユニバーサル
Header	ks.h (Ks.h を含む)
Library	Ks.lib
IRQL	<=DISPATCH_LEVEL