次の方法で共有

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

  • [アーティクル]

KsCompleteIo メソッドは、入力と出力 (I/O) の完了後に拡張ヘッダーをクリーンアップし、メディア サンプルを解放します。

構文

HRESULT KsCompleteIo(
  [in, out] PKSSTREAM_SEGMENT StreamSegment
);

パラメーター

[in, out] StreamSegment

完了するストリーム セグメントのヘッダー情報を含む KSSTREAM_SEGMENT 構造体へのポインター。

戻り値

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

備考

KsCompleteIo メソッドは、割り当てられたメモリを破棄し、メディア サンプルを更新し、プロキシの待機項目の数を減らします。

KsCompleteIo メソッドは、IKsInterfaceHandler::KsProcessMediaSamples メソッドが KSSTREAM_SEGMENT 構造体の IoOperation メンバーから完了した I/O 操作の種類を決定する必要があります。 I/O 操作がストリーム (KSIOOPERATION 列挙型のKsIoOperation_Read) からデータを読み取っていた場合、KsCompleteIo 次のアクションを実行して、出力ピンから接続された入力ピンにサンプルを配信します。

  • IMediaSample インターフェイスのストリーム ヘッダー情報を反映します。
  • 出力ピンの IKsPin::KsDeliver メソッドを呼び出して、サンプルを配信します。 KsDeliver は、バッファーをデバイスにキューに登録するときに、サンプルが最後のサンプルである場合に取得できるようにサンプルを解放します。 入力ピンは I/O を完了し、サンプルを解放しても安全です。
IMediaSampleの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー ksproxy.h (Ksproxy.h を含む)

関連項目

IKsInterfaceHandler::KsProcessMediaSamples

IKsPin::KsDeliver

KSSTREAM_SEGMENT