次の方法で共有

AVIFileOpenA 関数 (vfw.h)

  • [アーティクル]

AVIFileOpen 関数は AVI ファイルを開き、アクセスに使用するファイル インターフェイスのアドレスを返します。 AVIFile ライブラリは、ファイルが開かれた回数のカウントを保持しますが、解放された回数は保持しません。 AVIFileRelease 関数を使用して、ファイルを解放し、カウントを減らします。

構文

HRESULT AVIFileOpenA(
  PAVIFILE *ppfile,
  LPCSTR   szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

パラメーター

ppfile

インターフェイス ポインター 新しい IAVIFile を受け取るバッファーへのポインター。

szFile

開くファイルの名前を含む null で終わる文字列。

uMode

ファイルを開くときに使用するアクセス モード。 既定のアクセス モードはOF_READ。 AVIFileOpenでは、次 アクセス モードを指定できます。

価値 意味
OF_CREATE 新しいファイルを作成します。 ファイルが既に存在する場合は、長さが 0 に切り捨てられます。
OF_PARSE インデックスの作成など、時間のかかる操作をスキップします。 このフラグは、関数ができるだけ早く返されるようにする場合に設定します。たとえば、ファイルのプロパティに対してクエリを実行するが、ファイルを読み取らない場合などです。
OF_READ 読み取り用にファイルを開きます。
OF_READWRITE 読み取りと書き込みのためにファイルを開きます。
OF_SHARE_DENY_NONE ファイルを一時的に開きます。 他のプロセスでは、読み取りまたは書き込みアクセス権でファイルを開くことができます。 AVIFileOpen は、別のプロセスが互換モードでファイルを開いた場合に失敗します。
OF_SHARE_DENY_READ ファイルを一時的に開きます。 他のプロセスでは、書き込みアクセス権を持つファイルを開くことができます。 AVIFileOpen は、別のプロセスが互換モードでファイルを開いた場合、またはファイルへの読み取りアクセス権を持っている場合に失敗します。
OF_SHARE_DENY_WRITE ファイルを一時的に開きます。 他のプロセスでは、読み取りアクセス権を持つファイルを開くことができます。 AVIFileOpen は、別のプロセスが互換モードでファイルを開いた場合、またはファイルへの書き込みアクセス権を持っている場合に失敗します。
OF_SHARE_EXCLUSIVE ファイルを開き、他のプロセスへのアクセスを拒否します。 AVIFileOpen 、他のプロセスでファイルが開かれている場合は失敗します。
OF_WRITE 書き込み用のファイルを開きます。

lpHandler

使用する標準ハンドラーまたはカスタム ハンドラーのクラス識別子へのポインター。 値が NULL場合、システムは、ファイル拡張子またはファイルで指定された RIFF 型に基づいてレジストリからハンドラーを選択します。

戻り値

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

リターン コード 形容
AVIERR_BADFORMAT
 ファイルを読み取れませんでした。これは、破損したファイルまたは認識できない形式を示しています。
AVIERR_MEMORY
 メモリ不足のため、ファイルを開くことができませんでした。
AVIERR_FILEREAD
 ファイルの読み取り中にディスク エラーが発生しました。
AVIERR_FILEOPEN
 ファイルを開くときにディスク エラーが発生しました。
REGDB_E_CLASSNOTREG
 レジストリによると、AVIFileOpen で指定されたファイルの種類には、それを処理するハンドラーがありません。

備考

手記

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

必要条件

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

関連項目

AVIFile 関数 を する

AVIFile 関数とマクロ を する

AVIFileRelease の