mmioCreateChunk 函式 (mmiscapi.h)

mmioCreateChunk 函式會在使用 mmioOpen 函式開啟的 RIFF 檔案中建立區塊。 新的區塊會在目前的檔案位置建立。 建立新區塊之後，目前的檔案位置會是新區塊數據部分的開頭。

語法

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

參數

hmmio

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

pmmcki

接收 MMCKINFO 結構的緩衝區指標，其中包含要建立之區塊的相關信息。

fuCreate

旗標，識別要建立的區塊類型。 定義下列值。

傳回值

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

備註

此函式無法將區塊插入檔案中間。 如果應用程式嘗試在檔案結尾以外的位置建立區塊， mmioCreateChunk 會覆寫檔案中的現有資訊。

lpck 參數所指向的 MMCKINFO 結構應該設定如下：

• ckid 成員會指定區塊標識碼。 如果 wFlags 包含MMIO_CREATERIFF或MMIO_CREATELIST，此成員將會由 mmioCreateChunk 填入。
• 如果有任何) ，cksize 成員會指定區塊的數據部分大小，包括窗體類型或清單類型 (。 如果呼叫 mmioAscend 函式來標記區塊結尾時這個值不正確， mmioAscend 會更正區塊大小。
• 如果區塊是 「RIFF」 或 「LIST」 區塊， 則此範本 成員會指定表單類型或清單類型。 如果區塊不是 「RIFF」 或 「LIST」 區塊，則不需要填入此成員。
• dwDataOffset 成員不需要填入。 mmioCreateChunk 函式會將區塊數據部分的檔案位移填入此成員。
• dwFlags 成員不需要填入。 mmioCreateChunk 函式會在 dwFlags 中設定MMIO_DIRTY旗標。

規格需求