IKsInterfaceHandler::KsProcessMediaSamples メソッド (ksproxy.h)

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

KsProcessMediaSamples メソッドは、メディアサンプルを処理します。

構文

HRESULT KsProcessMediaSamples(
  [in]      IKsDataTypeHandler *KsDataTypeHandler,
  [in]      IMediaSample       **SampleList,
  [in, out] PLONG              SampleCount,
  [in]      KSIOOPERATION      IoOperation,
  [out]     PKSSTREAM_SEGMENT  *StreamSegment
);

パラメーター

[in] KsDataTypeHandler

SampleList に記載されているメディアの種類を処理するデータ型ハンドラーの IKsDataTypeHandler インターフェイスへのポインター。このデータ型ハンドラーには、ストリーミングされるメディアの種類に関する特定の情報があります。

[in] SampleList

処理するメディアサンプルの一覧の IMediaSample インターフェイスへのポインターの配列を含むバッファーへのポインター。

[in, out] SampleCount

SampleList のリスト内のサンプルの数を最初に含む変数へのポインター。戻り値として、処理されたサンプルの実際の数を受け取ります。

[in] IoOperation

I/O 操作の種類を示す値。この値には、KSIOOPERATION 列挙型の次のいずれかの値を指定できます。

値	説明
KsIoOperation_Write	ストリームにデータを書き込みます。
KsIoOperation_Read	ストリームからデータを読み取ります。

[out] StreamSegment

カーネルモードのピンに送信されるストリームセグメントのヘッダー情報を含む KSSTREAM_SEGMENT 構造体へのポインターを受け取るバッファーへのポインター。

戻り値

成功した場合は NOERROR を返します。それ以外の場合は、エラーコードを返します。

注釈

KsProcessMediaSamples メソッドは、以前に割り当てられたフィルターピンの間でサンプルを移動します。ストリームヘッダーは、ストリームセグメント内の各メディアサンプルを表すために初期化されます。入力と出力 (I/O) が実行され、待機項目の数が増加し、プロキシ I/O スレッドが完了を待機します。

KsProcessMediaSamples メソッドは、受信した IKsDataTypeHandler インターフェイスの KsQueryExtendedSize メソッドを呼び出して、拡張ヘッダーのサイズを取得します。拡張ヘッダーサイズが指定されていない場合、 KsProcessMediaSamples は IKsDataTypeHandler インターフェイスへのポインターを破棄します。拡張ヘッダーサイズが指定されている場合、 KsProcessMediaSamples は、メディアサンプルの処理が完了するまで IKsDataTypeHandler インターフェイスへのポインターを保持します。 KsProcessMediaSamples メソッドは、適切なヘッダーサイズでストリームヘッダーを割り当てます。メディアサンプルごとに、 KsProcessMediaSamples はヘッダーの初期化、データポインターのコピー、タイムスタンプの設定などを行います。その後、各サンプルがサンプルリストに追加されます。書き込み操作の場合、サンプルは参照カウントをインクリメントすることによって保持されます。

IMediaSample の詳細については、Microsoft Windows SDKドキュメントを参照してください。