fungsi mmioSetBuffer (mmiscapi.h)

Artikel
15/03/2023

Fungsi mmioSetBuffer memungkinkan atau menonaktifkan I/O buffer, atau mengubah ukuran buffer atau buffer untuk file yang dibuka dengan menggunakan fungsi mmioOpen .

Sintaks

MMRESULT mmioSetBuffer(
  HMMIO hmmio,
  LPSTR pchBuffer,
  LONG  cchBuffer,
  UINT  fuBuffer
);

Parameter

hmmio

Handel file file.

pchBuffer

Penunjuk ke buffer yang ditentukan aplikasi untuk digunakan untuk I/O buffer. Jika parameter ini NULL, mmioSetBuffer mengalokasikan buffer internal untuk I/O buffer.

cchBuffer

Ukuran, dalam karakter, dari buffer yang ditentukan aplikasi, atau ukuran buffer untuk mmioSetBuffer untuk dialokasikan.

fuBuffer

Dipesan; harus nol.

Menampilkan nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya. Jika terjadi kesalahan, handel file tetap valid. Nilai berikut ditentukan.

Menampilkan kode	Deskripsi
MMIOERR_CANNOTWRITE	Isi buffer lama tidak dapat ditulis ke disk, sehingga operasi dibatalkan.
MMIOERR_OUTOFMEMORY	Buffer baru tidak dapat dialokasikan, mungkin karena kurangnya memori yang tersedia.

Keterangan

Untuk mengaktifkan buffering menggunakan buffer internal, atur pchBuffer ke NULL dan cchBuffer ke ukuran buffer yang diinginkan.

Untuk menyediakan buffer Anda sendiri, atur pchBuffer untuk menunjuk ke buffer, dan atur cchBuffer ke ukuran buffer.

Untuk menonaktifkan I/O yang di-buffer, atur pchBuffer ke NULL dan cchBuffer ke nol.

Jika I/O yang di-buffer sudah diaktifkan menggunakan buffer internal, Anda dapat mengalokasikan kembali buffer ke ukuran yang berbeda dengan mengatur pchBuffer ke NULL dan cchBuffer ke ukuran buffer baru. Konten buffer dapat diubah setelah mengubah ukuran.

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