共用方式為

mmioAscend 函式 (mmiscapi.h)

  • 發行項

mmioAscend 函式會以 mmioDescend 函式遞減為 RIFF 檔案中的區塊遞增，或使用 mmioCreateChunk 函式建立。

語法

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

參數

hmmio

開啟之 RIFF 檔案的檔案句柄。

pmmcki

應用程式定義 MMCKINFO 結構的指標，先前由 mmioDescend 或 mmioCreateChunk 函式填入。

fuAscend

保留;必須是零。

傳回值

如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。

傳回碼 Description
MMIOERR_CANNOTSEEK
 在搜尋區塊結尾時發生錯誤。
MMIOERR_CANNOTWRITE
 緩衝區的內容無法寫入磁碟。

備註

如果使用 mmioDescend 遞減區塊， mmioAscend 會搜尋區塊結尾之後的位置，如果有任何) ，則會在區塊結尾 (。

如果區塊是使用 mmioCreateChunk 建立並遞減成 ，或者如果MMIO_DIRTY旗標是在 lpck 所參考 MMCKINFO 結構的 dwFlags 成員中設定，則會假設目前的檔案位置是區塊數據部分的結尾。 如果呼叫 mmioCreateChunk 時，區塊大小與儲存在 MMCKINFO 結構的 cksize 成員中的值不同，則 mmioAscend 會先更正檔案中的區塊大小，然後再從區塊遞增。 如果區塊大小為奇數， mmioAscend 會在區塊結尾寫入 Null 填補位元組。 從區塊遞增之後，如果有任何) ，則目前的檔案位置是區塊結尾之後 (超過額外填補位元組的位置。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 mmiscapi.h (包含 mmiscapi.h、Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll