AVIStreamRead 関数 (vfw.h)
AVIStreamRead 関数は、ストリームの種類に従ってストリームからオーディオ、ビデオ、またはその他のデータを読み取ります。
構文
HRESULT AVIStreamRead(
PAVISTREAM pavi,
LONG lStart,
LONG lSamples,
LPVOID lpBuffer,
LONG cbBuffer,
LONG *plBytes,
LONG *plSamples
);
パラメーター
pavi
開いているストリームへのハンドル。
lStart
読み取る最初のサンプル。
lSamples
読み取るサンプルの数。 ストリーム ハンドラーが読み取るサンプルの数を決定できるように、AVISTREAMREAD_CONVENIENT値を指定することもできます。
lpBuffer
データを格納するバッファーへのポインター。
cbBuffer
lpBuffer が指すバッファーのサイズ (バイト単位)。
plBytes
lpBuffer によって参照されるバッファーに書き込まれたデータのバイト数を受け取るバッファーへのポインター。 この値には NULL を指定できます。
plSamples
lpBuffer によって参照されるバッファーに書き込まれたサンプルの数を受け取るバッファーへのポインター。 この値には NULL を指定できます。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
リターン コード | 説明 |
---|---|
|
バッファー サイズ cbBuffer は、1 つのデータ サンプルよりも小さかったです。 |
|
読み取り操作を完了するのに十分なメモリが不足していました。 |
|
ファイルの読み取り中にディスク エラーが発生しました。 |
注釈
lpBuffer が NULL の場合、この関数はデータを読み取りません。読み取られるデータのサイズに関する情報を返します。
引数 pavi は、 IAVIStream インターフェイスへのポインターです。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | vfw.h |
Library | Vfw32.lib |
[DLL] | Avifil32.dll |