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

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

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ドキュメントを参照してください。