次の方法で共有

KsPinGetLeadingEdgeStreamPointer 関数 (ks.h)

  • [アーティクル]

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 返します。 pin に関連付けられたキューがないため、NULL の戻り値が発生する可能性があります。これは、ピンが標準トランスポート メカニズムを使用していないことを示します。 または、先頭のエッジ ロックしようとして失敗したために NULL の戻り値が発生する可能性があります。これは、先頭のエッジに関連付けられているデータ フレームがないことを示します。

備考

Pin-Centric 処理 を実装するフィルターは、KsPinGetLeadingEdgeStreamPointer 呼び出すことがよくあります。

必要条件

要件 価値
サポートされる最小クライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib
IRQL <=DISPATCH_LEVEL

関連項目

KsPinGetTrailingEdgeStreamPointer を する

KsStreamPointerAdvance の

KsStreamPointerAdvanceOffsetsAndUnlock の

KsStreamPointerClone の

KsStreamPointerDelete を する

KsStreamPointerLock を する

KsStreamPointerUnlock の