funzione waveOutGetDevCaps (mmeapi.h)

  • Articolo

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
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 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

Vedi anche

Waveform Audio

Funzioni waveform