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 会更正区块大小。
  • 如果区块是“RIFF”或“LIST”区块， 则 fccType 成员指定窗体类型或列表类型。 如果区块不是“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