Compartir a través de

Función mmioSetBuffer (mmiscapi.h)

  • Artículo

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.

Código devuelto Descripción
MMIOERR_CANNOTWRITE
 El contenido del búfer antiguo no se pudo escribir en el disco, por lo que se anuló la operación.
MMIOERR_OUTOFMEMORY
 No se pudo asignar el nuevo búfer, probablemente debido a una falta de memoria disponible.

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

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mmiscapi.h (include Mmiscapi.h, Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll