Video for WindowsのAVI API一覧

ライブラリ
ファイル
ストリーム
サンプル
ビデオストリーム/フレーム関係
ストリームの保存
編集ストリーム
クリップボード
構造体
索引

ライブラリ

VOID AVIFileInit(VOID)

機能ライブラリの初期化

VOID AVIFileExit(VOID)

機能ライブラリの解放

ファイル

STDAPI AVIFileOpen(PAVIFILE FAR ppfile,LPCTSTR szFile,UINT mode,CLSID FAR pclsidHandler)

機能 AVIファイルを開く

ppfile

ファイルインターフェイスポインタを受け取るアドレス。

szFile

ファイル名。

mode

ファイルを開く時に使用するアクセスモード。

OF_CREATE	新規にファイルを作成する、ファイルがすでに存在する場合その大きさは0になる
OF_READ	ファイルを読み取り専用で開く
OF_WRITE	ファイルを書き込み可能で開く
OF_READWRITE	読み取り/書き込み可能で開く
OF_SHARE_DENY_NONE	他のプロセスから読み書き可能
OF_SHARE_DENY_READ	他のプロセスから読み取り可能
OF_SHARE_DENY_WRITE	他のプロセスから書き込み可能
OF_SHARE_EXCLUSIVE	他のプロセスからアクセス不可

pclsidhandler

標準ハンドラまたはカスタムハンドラのクラス識別子のアドレス。

RET

0ならば成功。

STDAPI AVIMakeFileFromStreams(PAVIFILE ppfile,int nStreams,PAVISTREAM ppavi)

機能ストリームからファイルインターフェイスポインタを作る

ppfile	ファイルインターフェイスポインタを受け取るアドレス。
nStreams	ストリームの数。
ppavi	ストリームインターフェイスポインタを格納する配列へのポインタ。配列はnStreams分の大きさが必要です。
RET	0ならば成功。

ULONG AVIFileRelease(PAVIFILE pfile)

機能 AVIファイルを閉じる

pfile	ファイルインターフェイスポインタ。
RET	ファイルの参照カウンタを返す。(デバック目的に使用)

STDAPI AVIFileInfo(PAVIFILE pfile,LPAVIFILEINFO pfi,LONG lSize)

機能ファイルの情報を取得する

pfile	ファイルインターフェイスポインタ。
pfi	AVIFILEINFO構造体へのポインタ。
lSize	AVIFILEINFO構造体のバイトサイズ。
RET	0ならば成功。

ストリーム

STDAPI AVIFileGetStream(PAVIFILE pfile,PAVISTREAM FAR *ppavi,DWORD fccType,LONG lParam)

機能ストリームを開く

pfile

ファイルインターフェイスポインタ。

ppavi

ストリームインターフェイスポインタを受け取るアドレス。

fccType

開くストリームタイプを示す4文字のコードです。0の場合、すべてのストリームタイプが対象になります。下記の4種類が既に定義されています。

streamtypeAUDIO	オーディオストリーム
streamtypeMIDI	MIDIストリーム
streamtypeTEXT	テキストストリーム
streamtypeVIDEO	ビデオストリーム

lParam

ストリームタイプのカウンタです。0からストリーム数-1の範囲です。

RET

0ならば成功。

STDAPI AVIStreamOpenFromFile(PAVISTREAM FAR ppavi,LPCTSTR szfile,DWORD fccType,LONG lParam,UINT mode,CLSID FAR pclsidHandler)

機能ストリームをファイルから開く

ppavi

ストリームインターフェイスポインタを受け取るアドレス。

szFile

ファイル名。

fccType

開くストリームタイプを示す4文字のコードです。0の場合、すべてのストリームタイプが対象になります。下記の4種類が既に定義されています。

streamtypeAUDIO	オーディオストリーム
streamtypeMIDI	MIDIストリーム
streamtypeTEXT	テキストストリーム
streamtypeVIDEO	ビデオストリーム

mode

ファイルを開く時に使用するアクセスモード。

OF_CREATE	このAPIではファイルを新規に作ることはできない
OF_READ	ファイルを読み取り専用で開く
OF_WRITE	ファイルを書き込み可能で開く
OF_READWRITE	読み取り/書き込み可能で開く
OF_SHARE_DENY_NONE	他のプロセスから読み書き可能
OF_SHARE_DENY_READ	他のプロセスから読み取り可能
OF_SHARE_DENY_WRITE	他のプロセスから書き込み可能
OF_SHARE_EXCLUSIVE	他のプロセスからアクセス不可

pclsidhandler

標準ハンドラまたはカスタムハンドラのクラス識別子のアドレス。

RET

0ならば成功。

STDAPI AVIFileCreateStream(PAVIFILE pfile,PAVISTREAM FAR *ppavi,LPAVISTREAMINFO psi)

機能ストリームを新規作成する

pfile	ファイルインターフェイスポインタ。
ppavi	ストリームインターフェイスポインタを受け取るアドレス。
psi	AVISTREAMINFO構造体へのポインタ。
RET	0ならば成功。

STDAPI AVIMakeCompressedStream(PAVISTREAM ppsCompressed,PAVISTREAM psSource,LPAVICOMPRESSOPTIONS lpOptions,CLSID pclsidHandler)

機能圧縮ストリームを作る

ppsCompressed	圧縮ストリームインターフェイスポインタを受け取るアドレス。
psSource	圧縮ストリームインターフェイスポインタの元になるストリームインターフェイスポインタです。
lpOptions	圧縮オプションを格納するAVICOMPRESSOPTIONS構造体へのポインタです。
pclsidhandler	標準ハンドラまたはカスタムハンドラのクラス識別子のアドレス。
RET	0ならば成功。

LONG AVIStreamRelease(PAVISTREAME pavi)

機能ストリームを閉じる

pavi	ストリームインターフェイスポインタ。
RET	ストリームの参照カウンタを返す。(デバック目的に使用)

STDAPI AVIStreamInfo(PAVISTREAM pavi,LPAVISTREAMINFO psi,LONG lSize)

機能ストリームの情報を取得する

pavi	ストリームインターフェイスポインタ。
psi	AVISTREAMINFO構造体へのポインタ。
lSize	AVISTREAMINFO構造体のバイトサイズ。
RET	0ならば成功。

STDAPI AVIStreamReadFormat(PAVISTREAM pavi,LONG lPos,LPVOID lpFormat,LONG FAR *lpcbFormat)

機能ストリームのフォーマットを読み込む

pavi	ストリームインターフェイスポインタ。
lPos	サンプル番号。
lpFormat	フォーマットデータを格納するバッファへのポインタ。NULLのときにはlpcbFormatにフォーマットのバイト数が返されます。
lpcbFormat	読み込んだフォーマットのバイト数。
RET	0ならば成功。

STDAPI AVIStreamSetFormat(PAVISTREAM pavi,LONG lPos,LPVOID lpFormat,LONG cbFormat)

機能ストリームのフォーマットを設定する

pavi	ストリームインターフェイスポインタ。
lPos	サンプル番号。
lpFormat	フォーマットデータを格納するバッファへのポインタ。
cbFormat	フォーマットのバイト数。
RET	0ならば成功。

STDAPI AVIStreamRead(PAVISTREAM pavi,LONG lStart,LONG lSamples,LPVOID lpBuffer,LONG cbBuffer,LONG FAR plBytes,LONG FAR plSamples)

機能ストリームのデータを読み込む

pavi	ストリームインターフェイスポインタ。
lStart	読み込みをはじめるサンプル番号。
lSamples	サンプル数。
lpBuffer	データを格納するバッファへのポインタ。
cbBuffer	データのバイト数。
plBytes	読み込んだデータのバイト数。NULLにすることができる。
plSamples	読み込んだデータのサンプル数。NULLにすることができる。
RET	0ならば成功。

STDAPI AVIStreamWrite(PAVISTREAM pavi,LONG lStart,LONG lSamples,LPVOID lpBuffer,LONG cbBuffer,DWORD dwFlags,LONG FAR plSamples,LONG FAR plBytes)

機能ストリームにデータを書き込む

pavi	ストリームインターフェイスポインタ。
lStart	書き込みをはじめるサンプル番号。
lSamples	サンプル数。
lpBuffer	データを格納するバッファへのポインタ。
cbBuffer	データのバイト数。
dwFlags	ビデオストリームの場合、AVIIF_KEYFRAMEのみが定義されている。AVIIF_KEYFRAMEを指定したとき、フレームはキーフレームになる。
plSamples	書き込んだデータのサンプル数。NULLにすることができる。
plBytes	書き込んだデータのバイト数。NULLにすることができる。
RET	0ならば成功。

サンプル

LONG AVIStreamStart(PAVISTREAM pavi)

機能ストリームの先頭のサンプル番号を求める

pavi	ストリームインターフェイスポインタ。
RET	ストリームの先頭のサンプル番号。エラーの場合は-1が返される。

LONG AVIStreamLength(PAVISTREAM pavi)

機能ストリームの長さを求める

pavi	ストリームインターフェイスポインタ。
RET	ストリームのサンプル数。エラーの場合は-1が返される。

LONG AVIStreamSampleToTime(PAVISTREAM pavi,LONG lSample)

機能ストリームのサンプル番号から時間を求める

pavi	ストリームインターフェイスポインタ。
lSample	サンプル番号。
RET	サンプルの時間(ミリ秒単位)。エラーの場合は-1が返される。

LONG AVIStreamTimeToSample(PAVISTREAM pavi,LONG lTime)

機能ストリームの時間からサンプル番号を求める

pavi	ストリームインターフェイスポインタ。
lTime	時間(ミリ秒単位)。
RET	サンプル番号。エラーの場合は-1が返される。

ビデオストリーム/フレーム関係

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

機能ビデオストリームを検索する

pavi

ストリームインターフェイスポインタ。

lPos

検索をはじめるフレーム。

lFlags

フレームの種類と検索する方向を指定するフラグ。フォーマットの種類のいずれかと検索する方向のいずれか1つづつを指定します。
フォーマットの種類

FIND_ANY	空でないフレーム。
FIND_FORMAT	フォーマット変更。
FIND_KEY	キーフレーム。

検索する方向

FIND_FROM_START	ストリームの先頭から検索する。
FIND_PREV	前方。(検索を始めるフレームを含む)
FIND_NEXT	後方。(検索を始めるフレームを含む)

RET

見つかったフレーム。見つからない場合は-1が返される。

PGETFRAME AVIStreamGetFrameOpen(PAVISTREAM pavi,LPBITMAPINFOHEADER pbmih)

機能ビデオストリームからGetFrameオブジェクトを取得する

pavi	ストリームインターフェイスポインタ。
pbmih	BITMAPINFOHEADER構造体へのポインタ。フレームはBITMAPINFOHEADER構造体で指定されたフォーマットで展開されます。AVIGETFRAMEF_BESTDISPLAYFMTのときには表示に最適なフォーマットで展開されます。NULLのときはデフォルトのフォーマットで展開されます。
RET	GetFrameオブジェクト。エラーの場合はNULLが返される。

LPVOID AVIStreamGetFrame(PGETFRAME pget,LONG lPos)

機能 DIBに展開されたフレームを取得する

pget	GetFrameオブジェクト。
lPos	取得するフレーム。(サンプル番号)
RET	パックDIBへのポインタ。この値は次にAVIStreamGetFrameを呼び出すかAVIStreamGetFrameCloseを呼び出すまで有効です。

STDAPI AVIStreamGetFrameClose(PGETFRAME pget)

機能ビデオストリームから取得したGetFrameオブジェクトを解放する

pget	GetFrameオブジェクト。
RET	0ならば成功。

ストリームの保存

HRESULT AVISave(LPCTSTR szFile,CLSID FAR *pclsidHandler,AVISAVECALLBACK lpfnCallback,int nStreams,PAVISTREAM pavi,LPAVICOMPRESSOPTIONS lpOptions,...)

機能ストリームを保存する

szFile	ファイル名。
pclsidhandler	標準ハンドラまたはカスタムハンドラのクラス識別子のアドレス。
lpfnCallback	コールバック関数へのポインタ。コールバック関数を使用しない場合NULLを指定できる。
nStreams	ストリームの数。
pavi	ストリームインターフェイスポインタ。
lpOptions	AVICOMPRESSOPTIONS構造体へのポインタ。
RET	AVIERR_OKならば成功。

備考引数のpaviとlpOptionsはnStreamsの数だけ繰り返されます。

コールバック関数
LONG FAR PASCAL SaveCallback(int nPercent)

nPercent	保存処理の進行状況をパーセントで示します。
RET	保存処理を継続するときにはAVIERR_OK、中断するときにはAVIERR_USERABORTを返します。

STDAPI AVISaveV(LPCTSTR szFile,CLSID FAR pclsidHandler,AVISAVECALLBACK lpfnCallback,int nStreams,PAVISTREAM FAR ppavi,LPAVICOMPRESSOPTIONS FAR *plpOptions)

機能ストリームを保存するV

szFile	ファイル名。
pclsidhandler	標準ハンドラまたはカスタムハンドラのクラス識別子のアドレス。
lpfnCallback	コールバック関数へのポインタ。コールバック関数を使用しない場合NULLを指定できる。
nStreams	ストリームの数。
ppavi	ストリームインターフェイスポインタを格納する配列へのポインタ。配列はnStreams分の大きさが必要です。
plpOptions	圧縮オプションを格納するためのAVICOMPRESSOPTIONS構造体へのポインタを格納する配列へのポインタです。配列はnStreams分の大きさが必要です。
RET	AVIERR_OKならば成功。

コールバック関数
LONG FAR PASCAL SaveCallback(int nPercent)

nPercent	保存処理の進行状況をパーセントで示します。
RET	保存処理を継続するときにはAVIERR_OK、中断するときにはAVIERR_USERABORTを返します。

BOOL AVISaveOptions(HWND hWnd,UINT uiFlags,int nStreams,PAVISTREAM FAR ppavi,LPAVICOMPRESSOPTIONS FAR plpOptions)

機能保存オプションを取得する

hWnd

ダイアログボックスの親ウインドウ。

uiFlags

ダイアログボックスの表示に関するフラグを指定します。

ICMF_CHOOSE_KEYFRAME	キーフレームの項目を表示する。
ICMF_CHOOSE_DATARATE	データ比率の項目を表示する。
ICMF_CHOOSE_PREVIEW	プレビューボタンを表示する。

nStreams

ストリームの数。

ppavi

ストリームインターフェイスポインタを格納する配列へのポインタ。配列はnStreams分の大きさが必要です。

plpOptions

圧縮オプションを格納するためのAVICOMPRESSOPTIONS構造体へのポインタを格納する配列へのポインタです。配列はnStreams分の大きさが必要です。

RET

ユーザーがOKボタンを押したときTRUE、キャンセルボタンを押したときFALSEが返されます。

LONG AVISaveOptionsFree(int nStreams,LPAVICOMPRESSOPTIONS FAR *plpOptions)

機能保存オプションのリソースを解放する

nStreams	AVICOMPRESSOPTIONS構造体へのポインタの数。
plpOptions	圧縮オプションを格納するためのAVICOMPRESSOPTIONS構造体へのポインタを格納する配列へのポインタです。配列はnStreams分の大きさが必要です。
RET	AVIERR_OKが返されます。

編集ストリーム

STDAPI CreateEditableStream(PAVISTREAM FAR *ppsEditable,PAVISTREAM psSource)

機能編集ストリームを作成する

ppsEditable	編集ストリームインターフェイスポインタを受け取るアドレス。
psSource	編集ストリームインターフェイスポインタの元になるストリームインターフェイスポインタです。NULLを指定すると空の編集ストリームを作成します。
RET	0ならば成功。

STDAPI EditStreamClone(PAVISTREAM pavi,PAVISTREAM FAR *ppResult)

機能編集ストリームの複写を作成する

pavi	編集ストリームインターフェイスポインタ。
ppResult	複写された編集ストリームインターフェイスポインタを受け取るアドレス。
RET	0ならば成功。

STDAPI EditStreamCopy(PAVISTREAM pavi,LONG FAR plStart,LONG FAR plLength,PAVISTREAM FAR *ppResult)

機能編集ストリームをコピーする

pavi	編集ストリームインターフェイスポインタ。
plStart	コピーをはじめるストリームの位置(サンプル番号)を格納する変数へのポインタです。実際にコピーをはじめた位置が返されます。
plLength	コピーするサンプル数を格納する変数へのポインタです。実際にコピーされたサンプル数が返されます。
ppResult	コピーされた編集ストリームインターフェイスポインタを受け取るアドレス。
RET	0ならば成功。

STDAPI EditStreamCut(PAVISTREAM pavi,LONG FAR plStart,LONG FAR plLength,PAVISTREAM FAR *ppResult)

機能編集ストリームをカットする

pavi	編集ストリームインターフェイスポインタ。
plStart	カットをはじめるストリームの位置(サンプル番号)を格納する変数へのポインタです。実際に削除をはじめた位置が返されます。
plLength	カットするサンプル数を格納する変数へのポインタです。実際にカットされたサンプル数が返されます。
ppResult	カットされた編集ストリームインターフェイスポインタを受け取るアドレス。カットされた部分が不要な場合、アプリケーションはこれをAVIStreamReleaseで解放する必要があります。
RET	0ならば成功。

STDAPI EditStreamPaste(PAVISTREAM pavi,LONG FAR plPos,LONG FAR plLength,PAVISTREAM pstream,LONG lStart,LONG lLength)

機能編集ストリームに貼り付ける

pavi	編集ストリームインターフェイスポインタ。
plPost	挿入されるストリームの位置(サンプル番号)を格納する変数へのポインタです。実際に挿入された位置が返されます。
plLength	実際に貼り付けられたサンプル数が返されます。
pstream	貼り付けるストリームインターフェイスポインタ。編集ストリームインターフェイスポインタである必要ありません。
lStart	pstreamの貼り付けを開始する位置(サンプル番号)です。
lLength	pstreamの貼り付けるサンプル数です。-1を指定した場合、ストリーム全体を貼り付けます。
RET	0ならば成功。

STDAPI EditStreamSetInfo(PAVISTREAM pavi,LPAVISTREAMINFO lpInfo,LONG cbInfo)

機能編集ストリームの情報を設定する

pavi	編集ストリームインターフェイスポインタ。
lpInfo	AVISTREAMINFO構造体へのポインタ。
cbInfo	AVISTREAMINFO構造体のバイトサイズ。
RET	0ならば成功。

備考このAPIで設定できるAVISTREAMINFO構造体のメンバは下記のとおりです。

fccType	不可
fccHandler	不可
dwFlags	不可
dwCaps	不可
wPriority	可
wLanguage	可
dwScale	可
dwRate	可
dwStart	可
dwLength	不可
dwInitialFrames	不可
dwSuggestedBufferSize	不可
dwQuality	可
dwSampleSize	不可
rcFrame	可
dwEditCount	不可
dwFormatChangeCount	不可
szName	可

STDAPI EditStreamSetName(PAVISTREAM pavi,LPCSTR lpszName)

機能編集ストリームの説明文を設定する

pavi	編集ストリームインターフェイスポインタ。
lpszName	ストリームを説明するNULLで終わる文字列です。
RET	0ならば成功。

備考このAPIはAVISTREAMINFO構造体のszNameメンバを変更します。

クリップボード

STDAPI AVIClearClipboard(VOID)

機能クリップボードのAVIファイルを削除する

RET

0ならば成功。

STDAPI AVIGetFromClipboard(PAVIFILE *lppf)

機能クリップボードのAVIファイルをコピーする

lppf	ファイルインターフェイスポインタを受け取るアドレス。
RET	0ならば成功。

備考クリップボードにAVIファイルがない場合、CF_DIBまたはCF_WAVE形式のクリップボードデータから、ビデオストリームまたはオーディオストリームを作ります。

STDAPI AVIPutFileOnClipboard(PAVIFILE pf)

機能クリップボードにAVIファイルをコピーする

pf	ファイルインターフェイスポインタ。
RET	0ならば成功。

STDAPI AVIMakeStreamFromClipboard(UINT cfFormat,HANDLE hGlobal,PAVISTREAM FAR *ppstream)

機能クリップボードのストリームデータから編集ストリームを作成する

cfFormat	クリップボード形式。
hGlobal	クリップボードのストリームデータのハンドル。
ppstream	編集ストリームインターフェイスポインタを受け取るアドレス。
RET	0ならば成功。

構造体

AVICOMPRESSOPTIONS構造体


typedef struct { 
    DWORD  fccType;
    DWORD  fccHandler;
    DWORD  dwKeyFrameEvery;
    DWORD  dwQuality;
    DWORD  dwBytesPerSecond;
    DWORD  dwFlags;
    LPVOID lpFormat;
    DWORD  cbFormat;
    LPVOID lpParms;
    DWORD  cbParms;
    DWORD  dwInterleaveEvery;
} AVICOMPRESSOPTIONS;

fccType

開くストリームタイプを示す4文字のコードです。下記の4種類が既に定義されています。

streamtypeAUDIO	オーディオストリーム
streamtypeMIDI	MIDIストリーム
streamtypeTEXT	テキストストリーム
streamtypeVIDEO	ビデオストリーム

fccHandler

ビデオストリームを保存する時に圧縮するハンドラの4文字のコードです。(例えばmmioFOURCC('M','S','V','C'))
ビデオストリームでのみ使われます。

dwKeyFrameEvery

キーフレームの周期です。AVICOMPRESSF_KEYFRAMESフラグを指定したときのみこの値は使われます。それ以外ではすべてのフレームがキーフレームです。

dwQuality

ビデオストリームの品質。

dwBytesPerSecond

データ比率。AVICOMPRESSF_DATARATEフラグを指定したときのみこの値は使われます。

dwFlags

圧縮フラグ。

AVICOMPRESSF_DATARATE	dwBytesPerSecondのデータ比率を使ってビデオストリームを圧縮する。
AVICOMPRESSF_INTERLEAVE	dwInterleaveEveryフレームごとにインターリーブする。
AVICOMPRESSF_KEYFRAMES	dwKeyFrameEveryフレームごとにキーフレームを設定する。このフラグが指定されていないときにはすべてのフレームがキーフレームになります。
AVICOMPRESSF_VALID	この構造体のデータを使ってAVISaveOptionsの初期値を設定します。このフラグが指定されていないときにはデフォルトの値が使われます。

lpFormat

データフォーマット構造体へのポインタ。オーディオストリームではWAVEFORMAT構造体へのポインタです。

cbFormat

lpFormatで指定したデータフォーマット構造体のバイト数。

lpParams

ビデオ圧縮用のデータ。

cbParams

lpParamsで指定したデータのバイト数。

dwInterleaveEvery

インターリーブ値。AVICOMPRESSF_INTERLEAVEフラグを指定したときのみこの値は使われます。

AVIFIELDINDEX構造体


typedef struct {
    WORD     wLongsPerEntry;
    BYTE     bIndexSubType;
    BYTE     bIndexType;
    DWORD    nEntriesInUse;
    DWORD    dwChunkId;
    DWORDLONG qwBaseOffset;
    DWORD    dwReserved3;
    struct {
        DWORD dwOffset;
        DWORD dwSize;
        DWORD dwOffsetField2;
    } aIndex[];
} AVIFIELDINDEX;

wLongsPerEntry	必ず3です。
bIndexSubType	必ずAVI_INDEX_2FIELDです。
bIndexType	必ずAVI_INDEX_OF_CHUNKSです。
nEntriesInUse	aIndexの要素数。
dwChunkId	チャンクID、??dbまたは??dcです。
qwBaseOffset	AVISTDINDEX_ENTRY構造体のdwOffsetとこの値の合計が実際のオフセットになります。
dwReserved_3	予約。
aIndex.dwOffset	チャンクのデータのqwBaseOffsetに対する相対オフセットです。
aIndex.dwSize	チャンクのバイト数です。
aIndex.dwOffsetField2	チャンクのデータの第2フィールドへのqwBaseOffsetに対する相対オフセットです。

AVIFILEINFO構造体


typedef struct { 
    DWORD dwMaxBytesPerSec;
    DWORD dwFlags;
    DWORD dwCaps;
    DWORD dwStreams;
    DWORD dwSuggestedBufferSize;
    DWORD dwWidth;
    DWORD dwHeight;
    DWORD dwScale;
    DWORD dwRate;
    DWORD dwLength;
    DWORD dwEditCount;
    char  szFileType[64];
} AVIFILEINFO;

dwMaxBytesPerSec

近似の最大レート。

dwFlags

アプリケーションフラグ。

AVIFILEINFO_HASINDEX	AVIファイルはファイルの最後にインデックスをもっている。処理速度の向上のためにすべてのAVIファイルはインデックスを含まなければならない。
AVIFILEINFO_MUSTUSEINDEX	ファイルのインデックスにはファイルのチャンクを再生する順番が含まれている。データを再生するときにはこのインデックスが使われる。
AVIFILEINFO_ISINTERLEAVED	AVIファイルはインターリーブされている。
AVIFILEINFO_WASCAPTUREFILE	AVIファイルはリアルタイムビデオをキャプチャーするために使われる。
AVIFILEINFO_COPYRIGHTED	AVIファイルは著作権をともなう。アプリケーションはデータを複写してはいけない。

dwCaps

機能フラグ。

AVIFILECAPS_CANREAD	アプリケーションは読み取り専用で開くことができる。
AVIFILECAPS_CANWRITE	アプリケーションは書き込み可能で開くことができる。
AVIFILECAPS_ALLKEYFRAMES	すべてのフレームはキーフレームである。
AVIFILECAPS_NOCOMPRESSION	圧縮されていない。

dwStreams

ファイルに含まれるストリームの数。

dwSuggestedBufferSize

ファイルを読み込むときに適したバッファサイズです。この値は0のときもある。

dwWidth

ビットマップの幅。

dwHeight

ビットマップの高さ。

dwScale

ファイルの時間単位です。

dwRate

ファイルのレートです。

dwLength

ファイルの長さ。dwScaleとdwRateで単位が定義される。

dwEditCount

ファイルを編集(追加または削除)した回数です。

szFileType

ファイルタイプを説明するNULLで終わる文字列です。

AVIINDEXENTRY構造体


typedef struct
{
    DWORD ckid;
    DWORD dwFlags;
    DWORD dwChunkOffset;
    DWORD dwChunkLength;
} AVIINDEXENTRY;

ckid

チャンクID。先頭の2文字はストリーム番号を示す大文字16進数で、後の2文字はチャンクのタイプを示します。

??db	未圧縮DIB
??dc	圧縮されたDIB
??pc	パレットの変更を示すAVIPALCHANGE構造体
??wb	WAVEオーディオ

dwFlags

フラグ。

AVIIF_LIST	チャンクはリストチャンクである。
AVIIF_KEYFRAME	チャンクはキーフレームである。

dwChunkOffset

チャンクの4文字コードのオフセット。LISTチャンクmoviのmoviからの相対オフセット。

dwChunkLength

チャンクのバイト数。

AVIPALCHANGE構造体


typedef struct
{
    BYTE         bFirstEntry;
    BYTE         bNumEntries;
    WORD         wFlags;
    PALETTEENTRY peNew[];
} AVIPALCHANGE;

bFirstEntry	変更するパレットの最初のエントリー番号。
bNumEntries	変更するパレットのエントリー数。0ならば256。
wFlags	未使用。
peNew[]	新しいパレット。

AVIStreamHeader構造体


typedef struct {
    FOURCC fccType;
    FOURCC fccHandler;
    DWORD  dwFlags;
    WORD   wPriority;
    WORD   wLanguage;
    DWORD  dwInitialFrames;
    DWORD  dwScale;
    DWORD  dwRate;
    DWORD  dwStart;
    DWORD  dwLength;
    DWORD  dwSuggestedBufferSize;
    DWORD  dwQuality;
    DWORD  dwSampleSize;
    RECT   rcFrame;
} AVIStreamHeader;

fccType

開くストリームタイプを示す4文字のコードです。下記の4種類が既に定義されています。

streamtypeAUDIO	オーディオストリーム
streamtypeMIDI	MIDIストリーム
streamtypeTEXT	テキストストリーム
streamtypeVIDEO	ビデオストリーム

fccHandler

ビデオストリームを保存する時に圧縮するハンドラの4文字のコードです。(例えばmmioFOURCC('M','S','V','C'))
ビデオストリームでのみ使われます。

dwFlags

ストリームフラグ。

AVISF_DISABLED	ユーザーが使用可能にしたときにストリームはレンダされる。
AVISF_VIDEO_PALCHANGES	ビデオストリームはパレット変更を含む。このフラグは再生ソフトにパレットをアニメーションさせる必要があることを警告する。

dwCaps

機能フラグ。(現在は未使用)

wPriority

ストリームの優先順位。

wLanguage

ストリームの言語。

dwScale

ストリームの時間単位です。

dwRate

ストリームのレートです。

dwStart

AVIファイルの最初のフレームのサンプル番号です。dwScaleとdwRateで単位が定義される。通常は0です。

dwLength

ストリームの長さ。dwScaleとdwRateで単位が定義される。

dwInitialFrames

オーティオスキュー。インターリーブファイル内のビデオストリームの前方へオーディオストリームをどの程度ずらすかを指定する。通常は0.75秒。

dwSuggestedBufferSize

ストリームを読み込むときに適したバッファサイズです。この値は0のときもある。

dwQuality

ビデオストリームの品質です。0～10000の範囲で-1のときはデフォルトの品質です。

dwSampleSize

1つのデータサンプルのバイトサイズです。0の場合、サンプルのサイズは可変です。

rcFrame

表示を行う矩形です。ビデオストリームでのみ使われます。

AVISTREAMINFO構造体


typedef struct {
    DWORD fccType;
    DWORD fccHandler;
    DWORD dwFlags;
    DWORD dwCaps;
    WORD  wPriority;
    WORD  wLanguage;
    DWORD dwScale;
    DWORD dwRate;
    DWORD dwStart;
    DWORD dwLength;
    DWORD dwInitialFrames;
    DWORD dwSuggestedBufferSize;
    DWORD dwQuality;
    DWORD dwSampleSize;
    RECT  rcFrame;
    DWORD dwEditCount;
    DWORD dwFormatChangeCount;
    char  szName[64];
} AVISTREAMINFO;

fccType

開くストリームタイプを示す4文字のコードです。下記の4種類が既に定義されています。

streamtypeAUDIO	オーディオストリーム
streamtypeMIDI	MIDIストリーム
streamtypeTEXT	テキストストリーム
streamtypeVIDEO	ビデオストリーム

fccHandler

ビデオストリームを保存する時に圧縮するハンドラの4文字のコードです。(例えばmmioFOURCC('M','S','V','C'))
ビデオストリームでのみ使われます。

dwFlags

ストリームフラグ。

AVISTREAMINFO_DISABLED	ユーザーが使用可能にしたときにストリームはレンダされる。
AVISTREAMINFO_FORMATCHANGES	ビデオストリームはパレット変更を含む。このフラグは再生ソフトにパレットをアニメーションさせる必要があることを警告する。

dwCaps

機能フラグ。(現在は未使用)

wPriority

ストリームの優先順位。

wLanguage

ストリームの言語。

dwScale

ストリームの時間単位です。

dwRate

ストリームのレートです。

dwStart

AVIファイルの最初のフレームのサンプル番号です。dwScaleとdwRateで単位が定義される。通常は0です。

dwLength

ストリームの長さ。dwScaleとdwRateで単位が定義される。

dwInitialFrames

オーティオスキュー。インターリーブファイル内のビデオストリームの前方へオーディオストリームをどの程度ずらすかを指定する。通常は0.75秒。

dwSuggestedBufferSize

ストリームを読み込むときに適したバッファサイズです。この値は0のときもある。

dwQuality

ビデオストリームの品質です。0～10000の範囲で-1のときはデフォルトの品質です。

dwSampleSize

1つのデータサンプルのバイトサイズです。0の場合、サンプルのサイズは可変です。

rcFrame

表示を行う矩形です。ビデオストリームでのみ使われます。

dwEditCount

ファイルを編集(追加または削除)した回数です。

dwFormatChangeCount

フォーマットの変更回数。

szName

ストリームを説明するNULLで終わる文字列です。

AVISTDINDEX構造体


typedef {
    WORD      wLongsPerEntry;
    BYTE      bIndexSubType;
    BYTE      bIndexType;
    DWORD     nEntriesInUse;
    DWORD     dwChunkId;
    DWORDLONG qwBaseOffset;
    DWORD    dwReserved_3;
    struct {
        DWORD dwOffset;
        DWORD dwSize;
    } aIndex[];
} AVISTDINDEX;

wLongsPerEntry	必ず2です。
bIndexSubType	必ず0です。
bIndexType	必ずAVI_INDEX_OF_CHUNKSです。
nEntriesInUse	aIndexの要素数。
dwChunkId	チャンクID、例えば??db、??dc、??wbなどです。
qwBaseOffset	AVISTDINDEX_ENTRY構造体のdwOffsetとこの値の合計が実際のオフセットになります。
dwReserved_3	予約。
aIndex.dwOffset	チャンクのデータのqwBaseOffsetに対する相対オフセットです。
aIndex.dwSize	チャンクのバイト数です。

AVISUPERINDEX構造体


typedef struct {
    WORD  wLongsPerEntry;
    BYTE  bIndexSubType;
    BYTE  bIndexType;
    DWORD nEntriesInUse;
    DWORD dwChunkId;
    DWORD dwReserved[3];
    struct {
    DWORDLONG qwOffset;
        DWORD     dwSize;
        DWORD     dwDuration;
    } aIndex[];
} AVISUPERINDEX;

wLongsPerEntry	必ず4です。
bIndexSubType	AVISTDINDEX構造体のインデックスの時には0、AVIFIELDINDEX構造体のインデックスの時にはAVI_INDEX_2FIELDです。
bIndexType	必ずAVI_INDEX_OF_INDEXSです。
nEntriesInUse	aIndexの要素数。
dwChunkId	チャンクID、例えば??db、??dc、??wbなどです。
dwReserved	予約。
aIndex.qwOffset	チャンクIDのファイルオフセットです。
aIndex.dwSize	チャンクのバイト数です。
aIndex.dwDuration	チャンクが占めるストリーム単位の時間。

MainAVIHeader構造体


typedef struct
{
    DWORD dwMicroSecPerFrame;
    DWORD dwMaxBytesPerSec;
    DWORD dwPaddingGranularity;
    DWORD dwFlags;
    DWORD dwTotalFrames;
    DWORD dwInitialFrames;
    DWORD dwStreams;
    DWORD dwSuggestedBufferSize;
    DWORD dwWidth;
    DWORD dwHeight;
    DWORD dwReserved[4];
} MainAVIHeader;

dwMicroSecPerFrame

1フレームのミリ秒単位の表示時間、または0です。

dwMaxBytesPerSec

近似の最大レート。

dwPaddingGranularity

アライメントのバイト数、通常は2048バイトです。

dwFlags

アプリケーションフラグ。

AVIF_HASINDEX	AVIファイルはファイルの最後にインデックスをもっている。処理速度の向上のためにすべてのAVIファイルはインデックスを含まなければならない。
AVIF_MUSTUSEINDEX	ファイルのインデックスにはファイルのチャンクを再生する順番が含まれている。データを再生するときにはこのインデックスが使われる。
AVIF_ISINTERLEAVED	AVIファイルはインターリーブされている。
AVIF_WASCAPTUREFILE	AVIファイルはリアルタイムビデオをキャプチャーするために使われる。
AVIF_COPYRIGHTED	AVIファイルは著作権をともなう。アプリケーションはデータを複写してはいけない。

dwTotalFrames

ファイルの中のフレーム数。

dwInitialFrames

オーティオスキュー。インターリーブファイル内のビデオストリームの前方へオーディオストリームをどの程度ずらすかを指定する。通常は0.75秒。

dwStreams

ファイルに含まれるストリームの数。

dwSuggestedBufferSize

ファイルを読み込むときに適したバッファサイズです。この値は0のときもある。

dwWidth

ビットマップの幅。

dwHeight

ビットマップの高さ。

dwReserved

予約。

索引

AVIClearClipboard クリップボードのAVIファイルを削除する
AVIFileCreateStream ストリームを新規作成する
AVIFileExit ライブラリの解放
AVIFileGetStream ストリームを開く
AVIFileInfo ファイルの情報を取得する
AVIFileInit ライブラリの初期化
AVIFileOpen AVIファイルを開く
AVIFileRelease AVIファイルを閉じる
AVIGetFromClipboard クリップボードのAVIファイルをコピーする
AVIMakeCompressedStream 圧縮ストリームを作る
AVIMakeFileFromStreams ストリームからファイルインターフェイスポインタを作る
AVIMakeStreamFromClipboard クリップボードのストリームデータから編集ストリームを作成する
AVIPutFileOnClipboard クリップボードにAVIファイルをコピーする
AVISave ストリームを保存する
AVISaveOptions 保存オプションを取得する
AVISaveOptionsFree 保存オプションのリソースを解放する
AVISaveV ストリームを保存するV
AVIStreamFindSample ビデオストリームを検索する
AVIStreamGetFrame DIBに展開されたフレームを取得する
AVIStreamGetFrameClose ビデオストリームから取得したGetFrameオブジェクトを解放する
AVIStreamGetFrameOpen ビデオストリームからGetFrameオブジェクトを取得する
AVIStreamInfo ストリームの情報を取得する
AVIStreamLength ストリームの長さを求める
AVIStreamOpenFromFile ストリームをファイルから開く
AVIStreamRead ストリームのデータを読み込む
AVIStreamReadFormat ストリームのフォーマットを読み込む
AVIStreamRelease ストリームを閉じる
AVIStreamSampleToTime ストリームのサンプル番号から時間を求める
AVIStreamSetFormat ストリームのフォーマットを設定する
AVIStreamStart ストリームの先頭のサンプル番号を求める
AVIStreamTimeToSample ストリームの時間からサンプル番号を求める
AVIStreamWrite ストリームにデータを書き込む
CreateEditableStream 編集ストリームを作成する
EditStreamClone 編集ストリームの複写を作成する
EditStreamCopy 編集ストリームをコピーする
EditStreamCut 編集ストリームをカットする
EditStreamPaste 編集ストリームに貼り付ける
EditStreamSetInfo 編集ストリームの情報を設定する
EditStreamSetName 編集ストリームの説明文を設定する
AVICOMPRESSOPTIONS構造体
AVIFIELDINDEX構造体
AVIFILEINFO構造体
AVIINDEXENTRY構造体
AVIPALCHANGE構造体
AVIStreamHeader構造体
AVISTREAMINFO構造体
AVISTDINDEX構造体
AVISUPERINDEX構造体
MainAVIHeader構造体