Fungsi panggilan balik MMIOPROC (mmiscapi.h)

Fungsi MMIOProc adalah prosedur input/output (I/O) kustom yang diinstal oleh fungsi mmioInstallIOProc . MMIOProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi. Alamat fungsi ini dapat ditentukan dalam parameter callback-address mmioInstallIOProc.

Sintaks

MMIOPROC Mmioproc;

LRESULT Mmioproc(
  LPSTR lpmmioinfo,
  UINT uMsg,
  LPARAM lParam1,
  LPARAM lParam2
)
{...}

Parameter

lpmmioinfo

Menunjuk ke struktur MMIOINFO yang berisi informasi tentang file yang terbuka.

Prosedur I/O harus mempertahankan anggota lDiskOffset dalam struktur ini untuk menunjukkan offset file ke lokasi baca atau tulis berikutnya. Prosedur I/O dapat menggunakan anggota adwInfo[] untuk menyimpan informasi status. Prosedur I/O tidak boleh memodifikasi anggota lain dari struktur MMIOINFO .

uMsg

Menentukan pesan yang menunjukkan operasi I/O yang diminta. Pesan yang dapat diterima termasuk MMIOM_OPEN, MMIOM_CLOSE, MMIOM_READ, MMIOM_SEEK, MMIOM_WRITE, dan MMIOM_WRITEFLUSH.

lParam1

Menentukan parameter yang ditentukan aplikasi untuk pesan.

lParam2

Menentukan parameter yang ditentukan aplikasi untuk pesan.

Nilai kembali

Nilai yang dikembalikan tergantung pada pesan yang ditentukan oleh uMsg. Jika prosedur I/O tidak mengenali pesan, itu harus mengembalikan nol.

Keterangan

Kode empat karakter yang ditentukan oleh anggota fccMMIOProc dalam struktur MMIOINFO yang terkait dengan file mengidentifikasi ekstensi nama file untuk sistem penyimpanan kustom. Ketika aplikasi memanggil mmioOpen dengan nama file seperti "one.xyz+two", prosedur I/O yang terkait dengan kode empat karakter "XYZ" dipanggil untuk membuka elemen "dua" file "one.xyz".

Fungsi mmioInstallIOProc mempertahankan daftar terpisah prosedur I/O yang diinstal untuk setiap aplikasi berbasis Windows. Oleh karena itu, aplikasi yang berbeda dapat menggunakan pengidentifikasi prosedur I/O yang sama untuk prosedur I/O yang berbeda tanpa konflik. Namun, menginstal prosedur I/O secara global memungkinkan proses apa pun untuk menggunakan prosedur.

Jika aplikasi memanggil mmioInstallIOProc lebih dari sekali untuk mendaftarkan prosedur I/O yang sama, maka aplikasi harus memanggil mmioInstallIOProc untuk menghapus prosedur sekali untuk setiap kali menginstal prosedur.

mmioInstallIOProc tidak akan mencegah aplikasi menginstal dua prosedur I/O yang berbeda dengan pengidentifikasi yang sama, atau menginstal prosedur I/O dengan salah satu pengidentifikasi yang telah ditentukan sebelumnya ("DOS ", "MEM "). Prosedur yang paling baru diinstal lebih diutamakan, dan prosedur yang terakhir diinstal adalah prosedur pertama yang dihapus.

Saat mencari prosedur I/O tertentu, prosedur lokal dicari terlebih dahulu, lalu prosedur global.

Persyaratan