AVIBuildFilterW 関数 (vfw.h)

  • [アーティクル]

AVIBuildFilter 関数は、GetOpenFileName または GetSaveFileName 関数によって後で使用されるフィルター仕様を構築します。

構文

HRESULT AVIBuildFilterW(
  LPWSTR lpszFilter,
  LONG   cbFilter,
  BOOL   fSaving
);

パラメーター

lpszFilter

フィルター文字列を含むバッファーへのポインター。

cbFilter

lpszFilter が指すバッファーのサイズ (文字数)。

fSaving

フィルターに読み取り形式と書き込み形式のどちらを含めるかを示すフラグ。 書き込み形式を含めるには TRUE 、読み取り形式を含める 場合は FALSE を 指定します。

戻り値

成功した場合はAVIERR_OKを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
AVIERR_BUFFERTOOSMALL
 バッファー サイズ cbFilter が、生成されたフィルター仕様よりも小さかった。
AVIERR_MEMORY
 読み取り操作を完了するのに十分なメモリが不足していました。

注釈

この関数は、AVIFile ライブラリがマルチメディア ファイルの開き、読み取り、または書き込みに使用できるすべてのフィルターの種類のレジストリにアクセスします。 ハード ディスクでフィルター DLL と形式は検索されません。

注意

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

要件

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

こちらもご覧ください

AVIFile 関数

AVIFile 関数とマクロ