次の方法で共有


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

注釈

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

要件

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

こちらもご覧ください

KsPinGetTrailingEdgeStreamPointer

KsStreamPointerAdvance

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerClone

KsStreamPointerDelete

KsStreamPointerLock

KsStreamPointerUnlock