AVIStreamFindSample

Declare Function Api_AVIStreamFindSample& Lib "avifil32" Alias "AVIStreamFindSample" (ByVal pavi&, ByVal lPos&, ByVal lFlags&)

Declare Function AVIStreamFindSample Lib "avifil32" Alias "AVIStreamFindSample" (ByVal pavi As Long, ByVal lPos As Long, ByVal lFlags As Long) As Long

指定された位置からの相対的なサンプル(キーフレーム、空でないフレーム、フォーマット変更を含むフレーム)の位置を取得する。
この関数は、AVIStreamFindKeyFrame 関数に取って代わるものである。

パラメータ
pavi
    開いている AVI ストリームのハンドルを指定する。
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_KEY、FIND_ANY および FIND_FORMAT フラグは、同時に使うことはできない。同じように、IND_NEXT および FIND_PREV

    は同時に使うことはできない。