funzione waveInGetDevCaps (mmeapi.h)

  • Articolo

La funzione waveInGetDevCaps recupera le funzionalità di un determinato dispositivo di input waveform-audio.

Sintassi

MMRESULT waveInGetDevCaps(
  UINT         uDeviceID,
  LPWAVEINCAPS pwic,
  UINT         cbwic
);

Parametri

uDeviceID

Identificatore del dispositivo di output waveform-audio. Può essere un identificatore di dispositivo o un handle di un dispositivo di input audio a onda aperta.

pwic

Puntatore a una struttura WAVEINCAPS da compilare con informazioni sulle funzionalità del dispositivo.

cbwic

Dimensioni, in byte, della struttura WAVEINCAPS .

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_BADDEVICEID
 L'identificatore del dispositivo specificato non è compreso nell'intervallo.
MMSYSERR_NODRIVER
 Non è presente alcun driver di dispositivo.
MMSYSERR_NOMEM
 Impossibile allocare o bloccare la memoria.

Commenti

Usare questa funzione per determinare il numero di dispositivi di input audio waveform presenti nel sistema. Se il valore specificato dal parametro uDeviceID è un identificatore del dispositivo, può variare da zero a uno minore del numero di dispositivi presenti. La costante WAVE_MAPPER può essere usata anche come identificatore del dispositivo. Solo i byte cbwic (o meno) di informazioni vengono copiati nella posizione indicata da pwic. Se cbwic è zero, non viene copiato nulla e la funzione restituisce zero.

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

Vedi anche

Waveform Audio

Funzioni waveform