Función mmioSetBuffer (mmiscapi.h)

La función mmioSetBuffer habilita o deshabilita la E/S almacenada en búfer, o cambia el tamaño del búfer o búfer de un archivo abierto mediante la función mmioOpen .

Sintaxis

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

Parámetros

hmmio

Identificador de archivo del archivo.

pchBuffer

Puntero a un búfer definido por la aplicación que se va a usar para la E/S almacenada en búfer. Si este parámetro es NULL, mmioSetBuffer asigna un búfer interno para la E/S almacenada en búfer.

cchBuffer

Tamaño, en caracteres, del búfer definido por la aplicación o del tamaño del búfer para mmioSetBuffer que se va a asignar.

fuBuffer

Reservados; debe ser cero.

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario. Si se produce un error, el identificador de archivo permanece válido. Se definen los valores siguientes.

Comentarios

Para habilitar el almacenamiento en búfer mediante un búfer interno, establezca pchBuffer en NULL y cchBuffer en el tamaño de búfer deseado.

Para proporcionar su propio búfer, establezca pchBuffer para que apunte al búfer y establezca cchBuffer en el tamaño del búfer.

Para deshabilitar la E/S almacenada en búfer, establezca pchBuffer en NULL y cchBuffer en cero.

Si la E/S almacenada en búfer ya está habilitada mediante un búfer interno, puede reasignar el búfer a un tamaño diferente estableciendo pchBuffer en NULL y cchBuffer en el nuevo tamaño del búfer. El contenido del búfer se puede cambiar después de cambiar el tamaño.

Requisitos