funzione midiInGetErrorTextW (mmeapi.h)

La funzione midiInGetErrorText recupera una descrizione testuale per un errore identificato dal codice di errore specificato.

Sintassi

MMRESULT midiInGetErrorTextW(
  MMRESULT mmrError,
  LPWSTR   pszText,
  UINT     cchText
);

Parametri

mmrError

Codice di errore.

pszText

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

cchText

Lunghezza, in caratteri, del buffer a cui punta lpText.

Valore restituito

Restituisce MMSYSERR_NOERROR se ha 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_INVALPARAM
Il puntatore o la struttura specificati non è valido.
MMSYSERR_NOMEM
Il sistema non è in grado di 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 viene sempre terminata con valore Null. Se cchText è zero, non viene copiato nulla e la funzione restituisce zero. Tutte le descrizioni degli errori sono inferiori ai caratteri MAXERRORLENGTH lunghi.

Nota

L'intestazione mmeapi.h definisce midiInGetErrorText come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
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 (includere Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Funzioni MIDI