mmioAscend 函式 (mmiscapi.h)

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

語法

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

參數

hmmio

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

pmmcki

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

fuAscend

保留;必須是零。

傳回值

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

備註

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

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

規格需求