AVIStreamFindSample 関数 (vfw.h)

AVIStreamFindSample 関数は、指定した位置に対するサンプルの位置 (キーフレーム、空でないフレーム、または書式の変更を含むフレーム) を返します。

この関数は、古い AVIStreamFindKeyFrame 関数よりも 優先されます。

構文

LONG AVIStreamFindSample(
  PAVISTREAM pavi,
  LONG       lPos,
  LONG       lFlags
);

pavi

開いているストリームへのハンドル。

lPos

検索の開始フレーム。

lFlags

検索するフレームの種類、検索するストリームの方向、および戻り情報の種類を指定するフラグ。次のフラグが定義されています。

値	説明
FIND_ANY	空でないフレームを検索します。このフラグは、SEARCH_ANY フラグよりも優先されます。
FIND_KEY	キーフレームを検索します。このフラグは、SEARCH_KEY フラグよりも優先されます。
FIND_FORMAT	形式の変更を検索します。
FIND_NEXT	最も近いサンプル、フレーム、または形式の変更を検索します。現在のサンプルが検索に含まれています。このフラグは、FIND_ANY、FIND_KEY、または FIND_FORMAT フラグと共に使用します。このフラグは、SEARCH_FORWARD フラグよりも優先されます。
FIND_PREV	最も近いサンプル、フレーム、または形式の変更を検索して後方検索します。現在のサンプルが検索に含まれています。このフラグは、FIND_ANY、FIND_KEY、または FIND_FORMAT フラグと共に使用します。このフラグは、SEARCH_NEARESTおよびSEARCH_BACKWARDフラグよりも優先されます。
FIND_FROM_START	ストリームの先頭から始まる最初のサンプル、フレーム、または形式の変更を検索します。このフラグは、FIND_ANY、FIND_KEY、または FIND_FORMAT フラグと共に使用します。

見つかったフレームの位置を返します。検索が失敗した場合は -1 を返します。

FIND_NEXTフラグとFIND_PREV フラグと同様に、FIND_KEY、FIND_ANY、およびFIND_FORMATフラグは相互に排他的です。

引数 pavi には、IAVIStream インターフェイスへのポインターが含まれています。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	vfw.h
Library	Vfw32.lib
[DLL]	Avifil32.dll