Compartilhar via


Função midiOutGetErrorText (mmeapi.h)

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

Sintaxe

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

Parâmetros

mmrError

Código do erro.

pszText

Ponteiro para um 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.

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á MMSYSERR_NOERROR. 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