Compartilhar via


Função waveOutClose (mmeapi.h)

A função waveOutClose fecha o dispositivo de saída waveform-audio especificado.

Sintaxe

MMRESULT waveOutClose(
  HWAVEOUT hwo
);

Parâmetros

hwo

Identificador para o dispositivo de saída waveform-audio. Se a função for bem-sucedida, o identificador não será mais válido após essa chamada.

Retornar valor

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
MMSYSERR_INVALHANDLE
O identificador de dispositivo especificado é inválido.
MMSYSERR_NODRIVER
Nenhum driver de dispositivo está presente.
MMSYSERR_NOMEM
Não é possível alocar ou bloquear memória.
WAVERR_STILLPLAYING
Ainda há buffers na fila.

Comentários

A operação de fechamento falhará se o dispositivo ainda estiver reproduzindo um buffer de áudio de forma de onda que foi enviado anteriormente chamando waveOutWrite. Antes de chamar waveOutClose, o aplicativo deve aguardar até que todos os buffers terminem de ser reproduzidos ou chamar a função waveOutReset para encerrar a reprodução.

Requisitos

Requisito Valor
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 mmeapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Áudio de forma de onda

Funções waveform