Share via


Função waveOutReset (mmeapi.h)

A função waveOutReset interrompe a reprodução no dispositivo de saída waveform-audio especificado e redefine a posição atual como zero. Todos os buffers de reprodução pendentes são marcados como concluídos (WHDR_DONE) e retornados ao aplicativo.

Sintaxe

MMRESULT waveOutReset(
  HWAVEOUT hwo
);

Parâmetros

hwo

Manipule para o dispositivo de saída waveform-audio.

Valor retornado

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.
MMSYSERR_NOTSUPPORTED
O dispositivo especificado é síncrono e não dá suporte à pausa.

Comentários

Depois que essa função retornar, o aplicativo poderá enviar novos buffers de reprodução para o dispositivo chamando waveOutWrite ou fechar o dispositivo chamando waveOutClose.

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

Confira também

Áudio de forma de onda

Funções de forma de onda