KsPinGetLeadingEdgeStreamPointer 関数 (ks.h)

[アーティクル]
02/26/2024

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

構文

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

パラメーター

[in] Pin

先頭エッジストリームポインターを取得する必要があるキューを所有する KSPIN 構造体へのポインター。

[in] State

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

KSSTREAM_POINTER_STATE_UNLOCKED

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

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

KSSTREAM_POINTER_STATE_LOCKED

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

戻り値

KsPinGetLeadingEdgeStreamPointer は、KSSTREAM_POINTER構造体または NULL へのポインターを返します。 NULL の戻り値は、ピンに関連付けられているキューがないために発生する可能性があります。これは、ピンが標準のトランスポートメカニズムを使用していないことを示します。または、先頭のエッジをロックしようとして、先頭のエッジに関連付けられているデータフレームがないことを示すために、 NULL の戻り値が発生する可能性があります。

注釈

ピン中心の処理を実装するフィルターは、多くの場合、KsPinGetLeadingEdgeStreamPointer を呼び出します。

要件

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