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 |