AVISaveW 関数 (vfw.h)

AVISave 関数は、他のファイルまたはメモリからのデータ ストリームを組み合わせてファイルを構築します。

構文

HRESULT AVISaveW(
  LPCWSTR              szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           pfile,
  LPAVICOMPRESSOPTIONS lpOptions,
  ...                  
);

パラメーター

szFile

保存するファイルの名前を含む null で終わる文字列。

pclsidHandler

ファイルの書き込みに使用するファイル ハンドラーへのポインター。 このファイルは、このハンドラーを使用して AVIFileOpen 関数を呼び出すことによって作成されます。 ハンドラーが指定されていない場合は、ファイル拡張子に基づいてレジストリから既定値が選択されます。

lpfnCallback

保存操作のコールバック関数へのポインター。

nStreams

ファイルに保存されたストリームの数。

pfile

AVI ストリームへのポインター。 このパラメーターは、lpOptionsとペアになっています。 パラメーター ペアは、可変数の引数として繰り返すことができます。

lpOptions

paviによって参照されるストリームの圧縮オプションを含む、アプリケーション定義 AVICOMPRESSOPTIONS 構造体 ポインター。 このパラメーターは pavi とペアになっています。 パラメーター ペアは、可変数の引数として繰り返すことができます。

...

戻り値

成功した場合はAVIERR_OKを返し、それ以外の場合はエラーを返します。

備考

この関数は、ファイルを作成し、ストリーム データをファイルにコピーし、ファイルを閉じて、新しいファイルで使用されるリソースを解放します。 この関数の最後の 2 つのパラメーターは、ファイルに保存するストリームを識別し、そのストリームの圧縮オプションを定義します。 AVI ファイルに複数のストリームを保存する場合は、ファイル内のストリームごとにこれらの 2 つのストリーム固有のパラメーターを繰り返します。

(lpfnCallback使用して参照される) コールバック関数は、状態情報を表示し、ユーザーが保存操作を取り消すことができます。 コールバック関数は、次の形式を使用します。

LONG PASCAL SaveCallback(int nPercent)  

nPercent パラメーターは、保存されたファイルの割合を指定します。

コールバック関数は、操作を続行する必要がある場合はAVIERR_OKを返し、ユーザーが保存操作を中止する場合はAVIERR_USERABORTする必要があります。

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

手記

vfw.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして AVISave を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	vfw.h
ライブラリ	Vfw32.lib
DLL	Avifil32.dll

関連項目

AVIFile 関数 を する

AVIFile 関数とマクロ を する