fungsi mmioGetInfo (mmiscapi.h)

Artikel
08/24/2023

Fungsi mmioGetInfo mengambil informasi tentang file yang dibuka dengan menggunakan fungsi mmioOpen . Informasi ini memungkinkan aplikasi untuk langsung mengakses buffer I/O, jika file dibuka untuk I/O yang di-buffer.

Sintaks

MMRESULT mmioGetInfo(
  HMMIO      hmmio,
  LPMMIOINFO pmmioinfo,
  UINT       fuInfo
);

Parameter

hmmio

Handel file file.

pmmioinfo

Pointer ke buffer yang menerima struktur MMIOINFO yang diisi mmioGetInfo dengan informasi tentang file.

fuInfo

Dipesan; harus nol.

Menampilkan nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Untuk langsung mengakses buffer I/O file yang dibuka untuk I/O buffer, gunakan anggota struktur MMIOINFO berikut yang diisi oleh mmioGetInfo:

Anggota pchNext menunjuk ke byte berikutnya dalam buffer yang dapat dibaca atau ditulis. Saat Anda membaca atau menulis, kenaikan pchNext dengan jumlah byte yang dibaca atau ditulis.
Anggota pchEndRead menunjuk ke 1 byte melewati byte terakhir yang valid di buffer yang dapat dibaca.
Anggota pchEndWrite menunjuk ke 1 byte melewati lokasi terakhir di buffer yang dapat ditulis.

Setelah Anda membaca atau menulis ke buffer dan memodifikasi pchNext, jangan panggil fungsi I/O file multimedia kecuali mmioAdvance sampai Anda memanggil fungsi mmioSetInfo . Panggil mmioSetInfo ketika Anda selesai langsung mengakses buffer.

Ketika Anda mencapai akhir buffer yang ditentukan oleh anggota pchEndRead atau pchEndWrite , panggil mmioAdvance untuk mengisi buffer dari disk atau menulis buffer ke disk. Fungsi mmioAdvance memperbarui anggota pchNext, pchEndRead, dan pchEndWrite dalam struktur MMIOINFO untuk file.

Sebelum memanggil mmioAdvance atau mmioSetInfo untuk membersihkan buffer ke disk, atur bendera MMIO_DIRTY di anggota dwFlags dari struktur MMIOINFO untuk file. Jika tidak, buffer tidak akan ditulis ke disk.

Jangan menurunkan pchNext atau memodifikasi anggota apa pun dalam struktur MMIOINFO selain pchNext dan dwFlags. Jangan mengatur bendera apa pun di dwFlags kecuali MMIO_DIRTY.

Persyaratan


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

Bagikan melalui