mmioAscend 函数 (mmiscapi.h)

  • 项目

mmioAscend 函数从使用 mmioDescend 函数或使用 mmioCreateChunk 函数创建的 RIFF 文件中的区块中升出。

语法

MMRESULT mmioAscend(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuAscend
);

参数

hmmio

打开的 RIFF 文件的文件句柄。

pmmcki

指向应用程序定义的 MMCKINFO 结构的指针，该结构以前由 mmioDescend 或 mmioCreateChunk 函数填充。

fuAscend

保留;必须为零。

返回值

如果成功，则返回MMSYSERR_NOERROR，否则返回错误。 可能的错误值包括以下内容。

返回代码 说明
MMIOERR_CANNOTSEEK
 查找区块末尾时出错。
MMIOERR_CANNOTWRITE
 缓冲区的内容无法写入磁盘。

注解

如果使用 mmioDescend 将区块降到 ， 则 mmioAscend 会查找区块末尾之后的位置， (超出额外填充字节（如果有) ）。

如果区块是使用 mmioCreateChunk 创建并降到的，或者如果在 lpck 引用的 MMCKINFO 结构的 dwFlags 成员中设置了MMIO_DIRTY标志，则假定当前文件位置是区块数据部分的末尾。 如果区块大小与调用 mmioCreateChunk 时存储在 MMCKINFO 结构的 cksize 成员中的值不同，则 mmioAscend 在从区块升序之前更正文件中的区块大小。 如果区块大小为奇数， mmioAscend 会在区块末尾写入一个空板字节。 从区块升序后，当前文件位置是区块末尾之后的位置， (超出额外填充字节的位置（如果有任何) ）。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mmiscapi.h (包括 Mmiscapi.h、Windows.h)
Library Winmm.lib
DLL Winmm.dll