共用方式為

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。 可能的錯誤值包括下列專案。

傳回碼 Description
MMIOERR_CANNOTSEEK
 無法判斷區塊數據部分的位移。
MMIOERR_CANNOTWRITE
 無法寫入區塊標頭。

備註

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

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

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

規格需求

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