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 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
AVIERR_BUFFERTOOSMALL
 バッファー サイズ cbBuffer は、1 つのデータ サンプルよりも小さかったです。
AVIERR_MEMORY
 読み取り操作を完了するのに十分なメモリが不足していました。
AVIERR_FILEREAD
 ファイルの読み取り中にディスク エラーが発生しました。

注釈

lpBuffer が NULL の場合、この関数はデータを読み取りません。読み取られるデータのサイズに関する情報を返します。

引数 pavi は、 IAVIStream インターフェイスへのポインターです。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vfw.h
Library Vfw32.lib
[DLL] Avifil32.dll

こちらもご覧ください

AVIFile 関数

AVIFile 関数とマクロ