mmioCreateChunk 関数 (mmiscapi.h)

mmioCreateChunk 関数は、mmioOpen 関数を使用して開かれた RIFF ファイルにチャンクを作成します。新しいチャンクは、現在のファイル位置に作成されます。新しいチャンクが作成されると、現在のファイル位置は新しいチャンクのデータ部分の先頭になります。

構文

MMRESULT mmioCreateChunk(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuCreate
);

hmmio

開いている RIFF ファイルのファイルハンドル。

pmmcki

作成するチャンクに関する情報を含む MMCKINFO 構造体を受け取るバッファーへのポインター。

fuCreate

作成するチャンクの種類を識別するフラグ。次の値が定義されています。

値	意味
MMIO_CREATELIST	"LIST" チャンク。
MMIO_CREATERIFF	"RIFF" チャンク。

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

リターンコード	説明
MMIOERR_CANNOTSEEK	チャンクのデータ部分のオフセットを決定できません。
MMIOERR_CANNOTWRITE	チャンクヘッダーを書き込むことができません。

この関数は、ファイルの中央にチャンクを挿入できません。アプリケーションがファイルの末尾以外の場所にチャンクを作成しようとすると、 mmioCreateChunk によってファイル内の既存の情報が上書きされます。

lpck パラメーターが指す MMCKINFO 構造体は、次のように設定する必要があります。

ckid メンバーはチャンク識別子を指定します。 wFlags にMMIO_CREATERIFFまたはMMIO_CREATELISTが含まれている場合、このメンバーは mmioCreateChunk で塗りつぶされます。
cksize メンバーは、チャンクのデータ部分のサイズ (フォームの種類またはリストの種類 (存在する場合) を含む) を指定します。 mmioAscend 関数を呼び出してチャンクの末尾をマークするときにこの値が正しくない場合、mmioAscend はチャンクサイズを修正します。
fccType メンバーは、チャンクが "RIFF" または "LIST" チャンクである場合に、フォームの種類またはリストの種類を指定します。チャンクが "RIFF" または "LIST" チャンクでない場合、このメンバーを入力する必要はありません。
dwDataOffset メンバーを入力する必要はありません。 mmioCreateChunk 関数は、このメンバーにチャンクのデータ部分のファイルオフセットを設定します。
dwFlags メンバーを入力する必要はありません。 mmioCreateChunk 関数は、dwFlags でMMIO_DIRTY フラグを設定します。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mmiscapi.h (Mmiscapi.h、Windows.h を含む)
Library	Winmm.lib
[DLL]	Winmm.dll