Compartilhar via


Função mmioSetBuffer (mmiscapi.h)

A função mmioSetBuffer habilita ou desabilita a E/S em buffer ou altera o tamanho do buffer ou do buffer para um arquivo aberto usando a função mmioOpen .

Sintaxe

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

Parâmetros

hmmio

Identificador de arquivo do arquivo.

pchBuffer

Ponteiro para um buffer definido pelo aplicativo a ser usado para E/S em buffer. Se esse parâmetro for NULL, mmioSetBuffer alocará um buffer interno para E/S em buffer.

cchBuffer

Tamanho, em caracteres, do buffer definido pelo aplicativo ou o tamanho do buffer para mmioSetBuffer alocar.

fuBuffer

Reservados; deve ser zero.

Valor retornado

Retornará zero se tiver êxito ou um erro, caso contrário. Se ocorrer um erro, o identificador de arquivo permanecerá válido. Os valores a seguir são definidos.

Código de retorno Descrição
MMIOERR_CANNOTWRITE
O conteúdo do buffer antigo não pôde ser gravado no disco, portanto, a operação foi anulada.
MMIOERR_OUTOFMEMORY
O novo buffer não pôde ser alocado, provavelmente devido à falta de memória disponível.

Comentários

Para habilitar o buffer usando um buffer interno, defina pchBuffer como NULL e cchBuffer para o tamanho do buffer desejado.

Para fornecer seu próprio buffer, defina pchBuffer para apontar para o buffer e defina cchBuffer como o tamanho do buffer.

Para desabilitar a E/S em buffer, defina pchBuffer como NULL e cchBuffer como zero.

Se a E/S em buffer já estiver habilitada usando um buffer interno, você poderá realocar o buffer para um tamanho diferente definindo pchBuffer como NULL e cchBuffer para o novo tamanho do buffer. O conteúdo do buffer pode ser alterado após o redimensionamento.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmiscapi.h (inclua Mmiscapi.h, Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll