KsStreamPointerClone 関数 (ks.h)

[アーティクル]
03/05/2024

KsStreamPointerClone 関数は、指定されたストリームポインターの複製を作成します。

構文

KSDDKAPI NTSTATUS KsStreamPointerClone(
  [in]           PKSSTREAM_POINTER  StreamPointer,
  [in, optional] PFNKSSTREAMPOINTER CancelCallback,
  [in]           ULONG              ContextSize,
  [out]          PKSSTREAM_POINTER  *CloneStreamPointer
);

パラメーター

[in] StreamPointer

複製されるストリームポインターを表す KSSTREAM_POINTER 構造体へのポインター。

[in, optional] CancelCallback

省略可能。ミニドライバーが提供する AVStrMiniCancelCallback ルーチンへのポインター。 CloneStreamPointer に関連付けられている IRP が取り消された場合、AVStream はこのルーチンを呼び出します。

[in] ContextSize

このパラメーターは、結果の複製ストリームポインターに必要なミニドライバーコンテキスト情報のバイト数を示します。 0 以外の場合、要求されたバイト数は返されたストリームポインターの直後に割り当てられ、CloneStreamPointer の Context フィールドは割り当てられたメモリを指します。

[out] CloneStreamPointer

KSSTREAM_POINTER構造体へのポインターへのポインター。複製操作が正常に完了すると、 CloneStreamPointer には、複製されたストリームポインターのアドレスへのポインターが含まれます。

戻り値

KsStreamPointerClone は、複製操作が正常に完了したことを示すSTATUS_SUCCESS、または適切なエラーコードを返します。

注釈

結果の複製は、最初は元のストリームポインターと同じデータフレームを参照し、同じ状態 (ロックまたはロック解除) になります。データフレームを参照する複製ストリームポインターを追加すると、その特定のフレームの参照カウントがインクリメントされます。対象のフレーム、つまりフレームが属する IRP は、参照カウントが 0 になるまで完了しないことに注意してください。

割り当て呼び出しを最小限に抑えるには、この呼び出しの ContextSize パラメーターを使用できます。

「Stream ポインター」も参照してください。

要件

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