Compartilhar via


Função midiInGetErrorTextA (mmeapi.h)

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

Sintaxe

MMRESULT midiInGetErrorTextA(
  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.

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_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.

Observação

O cabeçalho mmeapi.h define midiInGetErrorText como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de funçã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

Funções MIDI