mmioOpenW 関数 (mmiscapi.h)

mmioOpen 関数は、バッファーなしまたはバッファーに入れられた I/O 用のファイルを開きます。はファイルを作成します。ファイルを削除します。または は、ファイルが存在するかどうかを確認します。 ファイルには、標準ファイル、メモリ ファイル、またはカスタム ストレージ システムの要素を指定できます。 mmioOpen によって返されるハンドルは、標準のファイル ハンドルではありません。マルチメディア ファイル I/O 関数以外のファイル I/O 関数では使用しないでください。

構文

HMMIO mmioOpenW(
  LPWSTR     pszFileName,
  LPMMIOINFO pmmioinfo,
  DWORD      fdwOpen
);

パラメーター

pszFileName

ファイルの名前を含むバッファーへのポインター。 ファイルを開く I/O プロシージャが指定されていない場合、次のようにファイル名によってファイルの開き方が決まります。

• ファイル名にプラス記号 (+) が含まれていない場合は、標準ファイルの名前 (つまり、型が HMMIO ではないファイル) であると見なされます。
• ファイル名が EXAMPLE という形式の場合。EXT+ ABC では、拡張子 EXT は、ファイルに対して I/O を実行するために呼び出されるインストール済みの I/O プロシージャを識別するものと見なされます。 詳細については、「 mmioInstallIOProc」を参照してください。
• ファイル名が NULL で、I/O プロシージャが指定されていない場合、MMIOINFO 構造体の adwInfo メンバーは、現在開いているファイルの標準 (HMMIO 以外) ファイル ハンドルであると見なされます。

メモリ ファイルを開くときは、 szFilename を NULL に設定します。

pmmioinfo

mmioOpen によって使用される追加のパラメーターを含む MMIOINFO 構造体へのポインター。 メモリ ファイルを開く場合、バッファー I/O 用のバッファーのサイズを指定する場合、またはアンインストールした I/O プロシージャを指定してファイルを開く場合を除き、このパラメーターは NULL にする必要があります。 このパラメーターが NULL でない場合、参照する MMIOINFO 構造体の未使用のメンバーはすべて、予約済みメンバーを含めて 0 に設定する必要があります。

fdwOpen

開いている操作のフラグ。 MMIO_READ、MMIO_WRITE、およびMMIO_READWRITEフラグは相互に排他的です。指定する必要があるのは 1 つだけです。 MMIO_COMPAT、MMIO_EXCLUSIVE、MMIO_DENYWRITE、MMIO_DENYREAD、およびMMIO_DENYNONEフラグは、ファイル共有フラグです。 次の値が定義されています。

戻り値

なし

解説

lpmmioinfo が MMIOINFO 構造体を指している場合は、次のように 構造体のメンバーを初期化します。 未使用のメンバーはすべて、予約済みメンバーを含め、0 に設定する必要があります。

• インストールされている I/O プロシージャでファイルを開くように要求するには、 fccIOProc を I/O プロシージャの 4 文字のコードに設定し、 pIOProc を NULL に設定 します。
• アンインストールされた I/O プロシージャでファイルを開くように要求するには、I/O プロシージャを指す IOProc を設定し、 fccIOProc を NULL に設定 します。
• szFilename に含まれるファイル名に基づいてファイルを開くために使用する I/O プロシージャを mmioOpen に要求するには、fccIOProc と pIOProc を NULL に設定します。 これは、MMIOINFO 構造体が指定されていない場合の既定の動作です。
• 内部的に割り当てられたマネージド バッファーを使用してメモリ ファイルを開くには、 pchBuffer を NULL に、 fccIOProc をFOURCC_MEMに、 cchBuffer をバッファーの初期サイズに設定し、 adwInfo をバッファーの増分拡張サイズに設定します。 このメモリ ファイルは、必要に応じて 、adwInfo で指定されたバイト数の増分で自動的に拡張されます。 dwOpenFlags パラメーターのMMIO_CREATE フラグを指定して、最初にファイルの末尾をバッファーの先頭に設定します。
• アプリケーション提供のバッファーを使用してメモリ ファイルを開くには、 pchBuffer をメモリ バッファーを指し、 fccIOProc をFOURCC_MEMに、 cchBuffer をバッファーのサイズに設定し、 adwInfo をバッファーの増分拡張サイズに設定します。 pchBuffer が GlobalAlloc 関数と GlobalLock 関数を呼び出して取得したポインターである場合にのみ、adwInfo の展開サイズは 0 以外にする必要があります。この場合、GlobalReAlloc 関数が呼び出され、バッファーが展開されます。 つまり、 pchBuffer がローカル配列またはグローバル配列、またはローカル ヒープ内のメモリ ブロックを指している場合、 adwInfo は 0 である必要があります。 dwOpenFlags パラメーターのMMIO_CREATE フラグを指定して、最初にファイルの末尾をバッファーの先頭に設定します。 それ以外の場合、メモリのブロック全体が読み取り可能と見なされます。
• マルチメディア ファイル I/O サービスで現在開いている標準ファイル ハンドル (つまり 、HMMIO 型を持たないファイル ハンドル) を使用するには、 fccIOProc を FOURCC_DOSに設定し、 pchBuffer を NULL に、 adwInfo を標準ファイル ハンドルに設定します。 ファイル内のオフセットはファイルの先頭に対して相対的であり、 mmioOpen が呼び出された時点での標準ファイル内の位置には関連しません。初期マルチメディア ファイル I/O オフセットは、 mmioOpen が呼び出されたときに標準ファイルのオフセットと同じになります。 標準ファイル ハンドルを閉じずにマルチメディア ファイル I/O ファイル ハンドルを閉じるには、MMIO_FHOPEN フラグを mmioClose に渡します。

要件