Bagikan melalui


fungsi mmioAscend (mmiscapi.h)

Fungsi mmioAscend naik dari gugus dalam file RIFF turun ke dalam dengan fungsi mmioDescend atau dibuat dengan fungsi mmioCreateChunk .

Sintaks

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

Parameter

hmmio

Handel file dari file RIFF terbuka.

pmmcki

Pointer ke struktur MMCKINFO yang ditentukan aplikasi yang sebelumnya diisi oleh fungsi mmioDescend atau mmioCreateChunk .

fuAscend

Dipesan; harus nol.

Nilai kembali

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

Menampilkan kode Deskripsi
MMIOERR_CANNOTSEEK
Ada kesalahan saat mencari ke akhir gugus.
MMIOERR_CANNOTWRITE
Isi penyangga tidak dapat ditulis ke disk.

Keterangan

Jika gugus turun ke dalam dengan menggunakan mmioDescend, mmioAscend mencari ke lokasi setelah akhir gugus (melewati byte pad tambahan, jika ada).

Jika gugus dibuat dan turun ke dalam dengan menggunakan mmioCreateChunk, atau jika bendera MMIO_DIRTY diatur dalam anggota dwFlags dari struktur MMCKINFO yang direferensikan oleh lpck, posisi file saat ini diasumsikan sebagai akhir dari bagian data dari gugus. Jika ukuran gugus tidak sama dengan nilai yang disimpan dalam anggota celah struktur MMCKINFO ketika mmioCreateChunk dipanggil, mmioAscend mengoreksi ukuran gugus dalam file sebelum naik dari gugus. Jika ukuran gugus ganjil, mmioAscend menulis byte pad null di akhir gugus. Setelah naik dari gugus, posisi file saat ini adalah lokasi setelah akhir gugus (melewati byte pad tambahan, jika ada).

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