funzione mixerGetDevCapsW (mmeapi.h)
La funzione mixerGetDevCaps esegue una query su un dispositivo mixer specificato per determinare le relative funzionalità.
Sintassi
MMRESULT mixerGetDevCapsW(
UINT_PTR uMxId,
LPMIXERCAPSW 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 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. |
|
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 inferiore al numero di dispositivi mixer presenti.
Solo il numero di byte (o meno) di informazioni specificate in cbmxcaps viene copiato nella posizione puntata da pmxcaps. Se cbmxcaps è zero, non viene copiato nulla e la funzione restituisce 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 in un UINT.
Nota
L'intestazione mmeapi.h definisce mixerGetDevCaps come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
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 |