funzione waveOutGetDevCaps (mmeapi.h)
La funzione waveOutGetDevCaps recupera le funzionalità di un determinato dispositivo di output waveform-audio.
Sintassi
MMRESULT waveOutGetDevCaps(
UINT uDeviceID,
LPWAVEOUTCAPS pwoc,
UINT cbwoc
);
Parametri
uDeviceID
Identificatore del dispositivo di output waveform-audio. Può essere un identificatore di dispositivo o un handle di un dispositivo di output audio a onda aperta.
pwoc
Puntatore a una struttura WAVEOUTCAPS da compilare con informazioni sulle funzionalità del dispositivo.
cbwoc
Dimensioni, in byte, della struttura WAVEOUTCAPS .
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 |
|---|---|
|
L'identificatore del dispositivo specificato non è compreso nell'intervallo. |
|
Non è presente alcun driver di dispositivo. |
|
Impossibile allocare o bloccare la memoria. |
Commenti
Usare la funzione waveOutGetNumDevs per determinare il numero di dispositivi di output waveform-audio 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 cbwoc (o meno) delle informazioni vengono copiati nella posizione a cui punta pwoc. Se cbwoc è 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 |