Funzione waveInGetDevCapsA (mmeapi.h)

La funzione waveInGetDevCapsA recupera le funzionalità di un determinato dispositivo di input audio waveform. Questa è la versione ANSI di questa funzione.

Sintassi

MMRESULT waveInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPWAVEINCAPSA pwic,
  UINT          cbwic
);

Parametri

uDeviceID

Identificatore del dispositivo di input audio waveform. Può essere un identificatore di dispositivo o un handle di un dispositivo di input audio waveform aperto.

pwic

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

cbwic

Dimensioni, in byte, della struttura WAVEINCAPSA .

Valore restituito

Restituisce MMSYSERR_NOERROR in caso di esito positivo o di errore. I possibili valori di errore includono quanto segue.

Codice restituito	Description
MMSYSERR_BADDEVICEID	L'identificatore di dispositivo specificato non è compreso nell'intervallo.
MMSYSERR_NODRIVER	Non è presente alcun driver di dispositivo.
MMSYSERR_NOMEM	Impossibile allocare o bloccare la memoria.

Osservazioni:

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 di dispositivo, può variare da zero a uno minore del numero di dispositivi presenti. La costante WAVE_MAPPER può essere usata anche come identificatore di dispositivo. Solo i byte cbwic (o meno) di informazioni vengono copiati nella posizione a cui punta pwic. Se cbwic è zero, non viene copiato alcun elemento e la funzione restituisce zero.

Requisiti

Requisito	Value
Client minimo supportato	Windows 2000 Professional
Server minimo supportato	Windows 2000 Server
Header	mmeapi.h
Library	Winmm.lib
DLL	Winmm.dll