funzione mixerGetDevCaps (mmeapi.h)
La funzione mixerGetDevCaps esegue una query su un dispositivo mixer specificato per determinare le relative funzionalità.
Sintassi
MMRESULT mixerGetDevCaps(
UINT uMxId,
LPMIXERCAPS pmxcaps,
UINT cbmxcaps
);
Parametri
uMxId
Identificatore o handle di un dispositivo mixer aperto.
pmxcaps
Puntatore a una struttura MIXERCAPS che riceve informazioni sulle funzionalità del dispositivo.
cbmxcaps
Dimensioni, in byte, della struttura MIXERCAPS .
Valore restituito
Restituisce MMSYSERR_NOERROR se l'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. |
|
L'handle del dispositivo mixer non è valido. |
|
Uno o più parametri non sono validi. |
Commenti
Usare la funzione mixerGetNumDevs per determinare il numero di dispositivi mixer presenti nel sistema. L'identificatore del dispositivo specificato da uMxId varia da zero a uno minore del numero di dispositivi mixer presenti.
Solo il numero di byte (o minore) di informazioni specificate in cbmxcaps viene copiato nella posizione a cui punta pmxcaps. Se cbmxcaps è zero, non viene copiato alcun elemento e la funzione viene restituita correttamente.
Questa funzione accetta anche un handle del dispositivo mixer restituito dalla funzione mixerOpen come parametro uMxId . L'applicazione deve eseguire il cast dell'handle HMIXER a un UINT.
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 (include Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |