AVISaveA 関数 (vfw.h)
AVISave 関数は、他のファイルまたはメモリからのデータ ストリームを組み合わせてファイルをビルドします。
構文
HRESULT AVISaveA(
LPCSTR 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 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vfw.h |
| Library | Vfw32.lib |
| [DLL] | Avifil32.dll |