AVISTREAMHEADER 構造体

[アーティクル]
04/22/2010

AVISTREAMHEADER 構造体は、AVI ファイル内の 1 つのストリームに関する情報を格納する。

構文

typedef struct _avistreamheader {
     FOURCC fcc;
     DWORD  cb;
     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;
     struct {
         short int left;
         short int top;
         short int right;
         short int bottom;
     }  rcFrame;
} AVISTREAMHEADER;

メンバ

fcc

FOURCC コードを指定する。値は 'strh' でなければならない。

構造体のサイズを指定する。最初の 8 バイト分を差し引いた値を指定する。

fccType

ストリームに含まれるデータのタイプを指定する FOURCC を含む。ビデオおよびオーディオに対して以下の標準 AVI 値が定義されている。

FOURCC	説明
'auds'	オーディオストリーム。
'mids'	MIDI ストリーム。
'txts'	テキストストリーム。
'vids'	ビデオストリーム。

fccHandler

特定のデータハンドラを示す FOURCC を含む (オプション)。データハンドラは、ストリームに対して適切なハンドラである。オーディオストリームまたはビデオストリームについて、ストリームをデコードするコーデックを指定する。

dwFlags

データストリームに対するフラグを含む。これらのフラグの上位ワードのビットは、ストリームに含まれるデータのタイプに固有である。以下の標準フラグが定義されている。

値	説明
AVISF_DISABLED	このストリームをデフォルトで有効にしないことを示す。
AVISF_VIDEO_PALCHANGES	このビデオストリームにパレットの変更が含まれることを示す。このフラグは、再生ソフトウェアに対して、パレットをアニメーションする必要があることを警告する。

dwPriority

ストリームタイプの優先順位を指定する。たとえば、複数のオーディオストリームを含むファイルでは、優先順位の最も高いストリームがデフォルトのストリームになる。

dwInitialFrames

インターリーブされたファイルで、オーディオデータがビデオフレームからどのくらいスキューされているかを指定する。通常は、約 0.75 秒である。インターリーブされたファイルを作成する場合、ファイル内で AVI シーケンスの開始フレームより前にあるフレーム数を、このメンバに指定する。このメンバの内容に関する詳細については、『Video for Windows Programmer's Guide』の「Special Information for Interleaved Files」を参照すること。

dwScale

dwRate と共に使って、このストリームが使うタイムスケールを指定する。dwRate を dwScale で割ることにより、1 秒あたりのサンプル数が求められる。ビデオストリームの場合、これはフレームレートである。オーディオストリームの場合、このレートは nBlockAlign バイトのオーディオの再生に必要な時間に相当する。これは PCM オーディオの場合はサンプルレートに等しくなる。

dwRate

dwScale を参照すること。

dwStart

このストリームの開始タイムを指定する。単位は、メインファイルヘッダーの dwRate および dwScale メンバによって定義される。Usually, this is zero, but it can specify a delay time for a stream that does not start concurrently with the file.

dwLength

このストリームの長さを指定する。単位は、ストリームのヘッダーの dwRate および dwScale メンバによって定義される。

dwSuggestedBufferSize

このストリームを読み取るために必要なバッファの大きさを指定する。通常は、ストリーム内の最大のチャンクに対応する値である。正しいバッファサイズを使うことで、再生の効率が高まる。正しいバッファサイズがわからない場合は、0 を指定する。

dwQuality

ストリーム内のデータの品質を示す値を指定する。品質は、0 ～ 10,000 の範囲の値で示される。圧縮データの場合、これは通常、圧縮ソフトウェアに渡される品質パラメータの値を示す。-1 に設定した場合、ドライバはデフォルトの品質値を使う。

dwSampleSize

データの 1 サンプルのサイズを指定する。サンプルのサイズが変化する場合は、0 に設定する。この値が 0 でない場合、ファイル内で複数のデータサンプルを 1 つのチャンクにグループ化できる。0 の場合、各データサンプル (ビデオフレームなど) はそれぞれ別のチャンクに含まれなければならない。ビデオストリームの場合、この値は通常 0 であるが、すべてのビデオフレームが同じサイズであれば、0 以外の値にもできる。オーディオストリームの場合、この値はオーディオを記述する WAVEFORMATEX 構造体の nBlockAlign メンバと同じでなければならない。

rcFrame

AVI メインヘッダー構造体の dwWidth および dwHeight メンバによって指定される動画矩形内のテキストまたはビデオストリームに対する転送先矩形を指定する。通常、rcFrame メンバは、複数のビデオストリームをサポートするために使われる。この矩形は、動画矩形に対応する座標に設定して、動画矩形全体を更新する。このメンバの単位はピクセルである。転送先矩形の左上隅は、動画矩形の左上隅からの相対指定となる。

注意

この構造体のメンバの一部は、AVIMAINHEADER 構造体にも存在している。AVIMAINHEADER 構造体に含まれるデータはファイル全体に適用されるが、AVISTREAMHEADER 構造体に含まれるデータは 1 つのストリームに対して適用される。

要件

Aviriff.h をインクルードすること。

参照

Share via

AVISTREAMHEADER 構造体

その他のリソース