fungsi mmioCreateChunk (mmiscapi.h)

Fungsi mmioCreateChunk membuat gugus dalam file RIFF yang dibuka dengan menggunakan fungsi mmioOpen . Gugus baru dibuat pada posisi file saat ini. Setelah gugus baru dibuat, posisi file saat ini adalah awal dari bagian data dari gugus baru.

Sintaks

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

Parameter

hmmio

Handel file dari file RIFF terbuka.

pmmcki

Pointer ke buffer yang menerima struktur MMCKINFO yang berisi informasi tentang gugus yang akan dibuat.

fuCreate

Bendera yang mengidentifikasi jenis gugus apa yang akan dibuat. Nilai berikut ditentukan.

Nilai	Makna
MMIO_CREATELIST	Potongan "LIST".
MMIO_CREATERIFF	Potongan "RIFF".

Mengembalikan nilai

Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
MMIOERR_CANNOTSEEK	Tidak dapat menentukan offset bagian data dari gugus.
MMIOERR_CANNOTWRITE	Tidak dapat menulis header gugus.

Keterangan

Fungsi ini tidak dapat menyisipkan gugus ke tengah file. Jika aplikasi mencoba membuat gugus di suatu tempat selain di akhir file, mmioCreateChunk menimpa informasi yang ada dalam file.

Struktur MMCKINFO yang diarahkan oleh parameter lpck harus disiapkan sebagai berikut:

• Anggota ckid menentukan pengidentifikasi gugus. Jika wFlags menyertakan MMIO_CREATERIFF atau MMIO_CREATELIST, anggota ini akan diisi oleh mmioCreateChunk.
• Anggota cksize menentukan ukuran bagian data dari gugus, termasuk jenis formulir atau jenis daftar (jika ada). Jika nilai ini tidak benar ketika fungsi mmioAscend dipanggil untuk menandai akhir gugus, mmioAscend mengoreksi ukuran gugus.
• Anggota fccType menentukan jenis formulir atau jenis daftar jika gugusnya adalah gugus "RIFF" atau "LIST". Jika gugus bukan gugus "RIFF" atau "LIST", anggota ini tidak perlu diisi.
• Anggota dwDataOffset tidak perlu diisi. Fungsi mmioCreateChunk mengisi anggota ini dengan offset file dari bagian data gugus.
• Anggota dwFlags tidak perlu diisi. Fungsi mmioCreateChunk mengatur bendera MMIO_DIRTY di dwFlags.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mmiscapi.h (termasuk Mmiscapi.h, Windows.h)
Pustaka	Winmm.lib
DLL	Winmm.dll