mmioSetBuffer

mmioSetBuffer 関数は mmioOpen 関数を使用してオープンしたファイルに対し、バッファード I/O の有効化/無効化、またはバッファ・バッファサイズの変更を行う。

mmioSetBuffer hmmio, pchBuffer, cchBuffer, fuBuffer

hmmio : [intptr] ファイルのファイルハンドル。
pchBuffer : [str] バッファード I/O に使用するアプリケーション定義バッファへのポインタ。このパラメータが NULL の場合、mmioSetBuffer はバッファード I/O 用の内部バッファを割り当てる。
cchBuffer : [int] アプリケーション定義バッファのサイズ (文字単位)、または mmioSetBuffer が割り当てるバッファのサイズ。
fuBuffer : [int] 予約。0 でなければならない。

(プラグイン / モジュール : winmm.dll)

解説

mmioSetBuffer 関数は mmioOpen 関数を使用してオープンしたファイルに対し、バッファード I/O
の有効化/無効化、またはバッファ・バッファサイズの変更を行う。

[戻り値]
成功時は 0 を、それ以外の場合はエラーを返す。エラーが発生してもファイルハンドルは有効なままである。次の値が定義されている。
（以下省略）

[備考]
内部バッファを使用してバッファリングを有効にするには、pchBuffer を NULL に、cchBuffer
を希望するバッファサイズに設定する。独自のバッファを供給するには、pchBuffer をそのバッファを指すように設定し、cchBuffer
をバッファのサイズに設定する。バッファード I/O を無効にするには、pchBuffer を NULL に、cchBuffer を 0
に設定する。内部バッファを使用してバッファード I/O が既に有効になっている場合、pchBuffer を NULL
に、cchBuffer
を新しいバッファサイズに設定することでバッファのサイズを変更して再割り当てできる。サイズ変更後はバッファの内容が変わる可能性がある。

情報