Compartir a través de


Función waveOutGetErrorText (mmeapi.h)

La función waveOutGetErrorText recupera una descripción textual del error identificado por el número de error especificado.

Sintaxis

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

Parámetros

mmrError

Número de error.

pszText

Puntero a un búfer que se va a rellenar con la descripción del error textual.

cchText

Tamaño, en caracteres, del búfer al que apunta pszText.

Valor devuelto

Devuelve MMSYSERR_NOERROR si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.

Código devuelto Descripción
MMSYSERR_BADERRNUM
El número de error especificado está fuera del intervalo.
MMSYSERR_NODRIVER
No hay ningún controlador de dispositivo presente.
MMSYSERR_NOMEM
No se puede asignar o bloquear la memoria.

Comentarios

Si la descripción del error textual es mayor que el búfer especificado, la descripción se trunca. La cadena de error devuelta siempre termina en null. Si cchText es cero, no se copia nada y la función devuelve cero. Todas las descripciones de errores tienen menos de caracteres MAXERRORLENGTH.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mmeapi.h (incluye Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda