funzione waveOutGetDevCapsW (mmeapi.h)

La funzione waveOutGetDevCapsW recupera le funzionalità di un determinato dispositivo di output audio waveform. Questa è la versione Unicode della funzione.

Sintassi

MMRESULT waveOutGetDevCapsW(
  UINT_PTR       uDeviceID,
  LPWAVEOUTCAPSW pwoc,
  UINT           cbwoc
);

Parametri

uDeviceID

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

pwoc

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

cbwoc

Dimensioni, in byte, della struttura WAVEOUTCAPSW .

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 la funzione waveOutGetNumDevs per determinare il numero di dispositivi di output 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 cbwoc (o meno) di informazioni vengono copiati nella posizione a cui punta pwoc. Se cbwoc è zero, non viene copiato nulla 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

Vedere anche

Waveform Audio

Funzioni waveform