IKsPin::KsDeliver メソッド (ksproxy.h)

KsDeliver メソッドは、出力ピンから入力ピンにメディアサンプルを配信し、アロケーターから次のバッファーを取得して I/O 操作を続行し、関連付けられたデバイスにバッファーを送信します。

構文

HRESULT KsDeliver(
  [in] IMediaSample *Sample,
  [in] ULONG        Flags
);

[in] Sample

関連付けられているメディアサンプルの IMediaSample インターフェイスへのポインター。

[in] Flags

メディアサンプルのストリームヘッダーに関する情報を列挙するビットマスクを指定します。次のフラグのビットごとの OR の組み合わせが可能です。

KSSTREAM_HEADER_OPTIONSF_SPLICEPOINT

KSSTREAM_HEADER_OPTIONSF_PREROLL

KSSTREAM_HEADER_OPTIONSF_DATADISCONTINUITY

KSSTREAM_HEADER_OPTIONSF_TYPECHANGED

KSSTREAM_HEADER_OPTIONSF_TIMEVALID

KSSTREAM_HEADER_OPTIONSF_TIMEDISCONTINUITY

KSSTREAM_HEADER_OPTIONSF_FLUSHONPAUSE

KSSTREAM_HEADER_OPTIONSF_DURATIONVALID

KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM

KSSTREAM_HEADER_OPTIONSF_LOOPEDDATA

これらのフラグは、KSSTREAM_HEADER構造体の説明の OptionsFlags メンバーで定義されます。

ピン接続は、ストリームの終了フラグ (KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM) をチェックして、サンプルの完了後にストリームの終了イベントを配信する必要があるかどうかを判断します。

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

インターフェイスハンドラー (IKsInterfaceHandler) は、フィルターの出力ピンで KsDeliver を呼び出して、メディアサンプルを別のフィルターの入力ピンに配信します。これらの入力ピンと出力ピンが接続されています。

入力ピンの場合、 KsDeliver は無効なエントリポイントであり、EFAIL を返します。

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

要件	値
対象プラットフォーム	デスクトップ
Header	ksproxy.h (Ksproxy.h を含む)