Share via

Função waveOutGetErrorText (mmeapi.h)

  • Artigo

A função waveOutGetErrorText recupera uma descrição textual do erro identificado pelo número de erro especificado.

Sintaxe

MMRESULT waveOutGetErrorText(
  MMRESULT mmrError,
  LPSTR    pszText,
  UINT     cchText
);

Parâmetros

mmrError

Número de erro.

pszText

Ponteiro para um buffer a ser preenchido com a descrição do erro textual.

cchText

Tamanho, em caracteres, do buffer apontado por pszText.

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_BADERRNUM
 O número de erro especificado está fora do intervalo.
MMSYSERR_NODRIVER
 Nenhum driver de dispositivo está presente.
MMSYSERR_NOMEM
 Não é possível alocar ou bloquear memória.

Comentários

Se a descrição do erro textual for maior que o buffer especificado, a descrição será truncada. A cadeia de caracteres de erro retornada é sempre terminada em nulo. Se cchText for zero, nada será copiado e a função retornará zero. Todas as descrições de erro têm menos de caracteres MAXERRORLENGTH.

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