Share via

Funzione waveOutGetErrorText (mmeapi.h)

  • Articolo

La funzione waveOutGetErrorText recupera una descrizione testuale dell'errore identificato dal numero di errore specificato.

Sintassi

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

Parametri

mmrError

Numero di errore.

pszText

Puntatore a un buffer da riempire con la descrizione dell'errore testuale.

cchText

Dimensioni, in caratteri, del buffer a cui punta pszText.

Valore restituito

Restituisce MMSYSERR_NOERROR se l'esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito Descrizione
MMSYSERR_BADERRNUM
 Il numero di errore specificato non è compreso nell'intervallo.
MMSYSERR_NODRIVER
 Non è presente alcun driver di dispositivo.
MMSYSERR_NOMEM
 Impossibile allocare o bloccare la memoria.

Commenti

Se la descrizione dell'errore testuale è più lunga del buffer specificato, la descrizione viene troncata. La stringa di errore restituita è sempre con terminazione Null. Se cchText è zero, non viene copiato nulla e la funzione restituisce zero. Tutte le descrizioni degli errori sono inferiori ai caratteri MAXERRORLENGTH.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mmeapi.h (include Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Waveform Audio

Funzioni waveform