Funzione auxGetDevCapsW (mmeapi.h)
La funzione auxGetDevCaps recupera le funzionalità di un determinato dispositivo di output ausiliario.
Sintassi
MMRESULT auxGetDevCapsW(
UINT_PTR uDeviceID,
LPAUXCAPSW pac,
UINT cbac
);
Parametri
uDeviceID
Identificatore del dispositivo di output ausiliario su cui eseguire query. Specificare un identificatore di dispositivo valido (vedere la sezione dei commenti seguenti) oppure usare la costante seguente:
| Valore | Significato |
|---|---|
| AUX_MAPPER | Mapper audio ausiliario. La funzione restituisce un errore se non è installato alcun mapper audio ausiliario. |
pac
Puntatore a una struttura AUXCAPS da compilare con informazioni sulle funzionalità del dispositivo.
cbac
Dimensioni, in byte, della struttura AUXCAPS .
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. |
Commenti
L'identificatore del dispositivo in uDeviceID varia da zero a uno minore del numero di dispositivi presenti. AUX_MAPPER possono essere usate anche. Usare la funzione auxGetNumDevs per determinare il numero di dispositivi di output ausiliari presenti nel sistema.
Nota
L'intestazione mmeapi.h definisce auxGetDevCaps come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |