Share via

Função midiInGetErrorText (mmeapi.h)

  • Artigo

A função midiInGetErrorText recupera uma descrição textual de um erro identificado pelo código de erro especificado.

Sintaxe

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

Parâmetros

mmrError

Código do erro.

pszText

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

cchText

Comprimento, em caracteres, do buffer apontado por lpText.

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_BADERRNUM
 O número de erro especificado está fora do intervalo.
MMSYSERR_INVALPARAM
 O ponteiro ou estrutura especificado é inválido.
MMSYSERR_NOMEM
 O sistema não pode 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

   
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

Funções MIDI