CPullPin.Seek メソッド

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは Seek 、ストリームの開始位置と停止位置を設定します。

構文

HRESULT Seek(
   REFERENCE_TIME tStart,
   REFERENCE_TIME tStop
);

パラメーター

tStart

開始位置をバイト単位で 10,000,000 で乗算して指定します。

tStop

停止位置をバイト単位で 10,000,000 で乗算して指定します。

戻り値

メソッドが成功した場合はS_OKを返し、それ以外の場合はエラー コードを返します。

解説

ワーカー スレッドが実行されている場合、 メソッドはスレッドを一時停止し、フィルター グラフをフラッシュして、スレッドを再開します。 スレッドは、新しい開始位置からデータのプルを開始します。 それ以外の場合、スレッドが開始されるたびに新しい位置の値が有効になります。

位置は、元のソースの開始位置を基準とします。 目的のバイト オフセットに、基底クラス ライブラリで 10,000,000 として定義されている定数 UNITS を乗算します。

ピンが最初に接続されると、停止位置と開始位置は既定でストリームの開始位置と終了位置になります。

要件

要件 値
ヘッダー
Pullpin.h
ライブラリ
Strmbase.lib (小売ビルド);
Strmbasd.lib (デバッグ ビルド)

関連項目

CPullPin クラス