funzione mmioSetBuffer (mmiscapi.h)

La funzione mmioSetBuffer abilita o disabilita l'I/O memorizzata nel buffer o modifica la dimensione del buffer o del buffer per un file aperto usando la funzione mmioOpen .

Sintassi

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

Parametri

hmmio

Handle file del file.

pchBuffer

Puntatore a un buffer definito dall'applicazione da usare per l'I/O memorizzato nel buffer. Se questo parametro è NULL, mmioSetBuffer alloca un buffer interno per l'I/O memorizzato nel buffer.

cchBuffer

Dimensioni, in caratteri, del buffer definito dall'applicazione o delle dimensioni del buffer per mmioSetBuffer da allocare.

fuBuffer

Riservati; deve essere zero.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario. Se si verifica un errore, l'handle di file rimane valido. I valori seguenti sono definiti.

Codice restituito	Descrizione
MMIOERR_CANNOTWRITE	Impossibile scrivere il contenuto del buffer precedente su disco, quindi l'operazione è stata interrotta.
MMIOERR_OUTOFMEMORY	Impossibile allocare il nuovo buffer, probabilmente a causa di una mancanza di memoria disponibile.

Commenti

Per abilitare il buffering usando un buffer interno, impostare pchBuffer su NULL e cchBuffer sulla dimensione del buffer desiderata.

Per specificare il buffer personalizzato, impostare pchBuffer per puntare al buffer e impostare cchBuffer sulle dimensioni del buffer.

Per disabilitare l'I/O con buffer, impostare pchBuffer su NULL e cchBuffer su zero.

Se l'I/O memorizzato nel buffer è già abilitato usando un buffer interno, è possibile riallocare il buffer in una dimensione diversa impostando pchBuffer su NULL e cchBuffer sulla nuova dimensione del buffer. Il contenuto del buffer può essere modificato dopo il ridimensionamento.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mmiscapi.h (includono Mmiscapi.h, Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll