Funzione midiOutGetDevCaps (mmeapi.h)
La funzione midiOutGetDevCaps esegue una query su un dispositivo di output MIDI specificato per determinare le relative funzionalità.
Sintassi
MMRESULT midiOutGetDevCaps(
UINT uDeviceID,
LPMIDIOUTCAPS pmoc,
UINT cbmoc
);
Parametri
uDeviceID
Identificatore del dispositivo di output MIDI. L'identificatore del dispositivo specificato da questo parametro varia da zero a uno minore del numero di dispositivi presenti. La costante MIDI_MAPPER è anche un identificatore di dispositivo valido.
Questo parametro può anche essere un handle del dispositivo di cast corretto.
pmoc
Puntatore a una struttura MIDIOUTCAPS . Questa struttura contiene informazioni sulle funzionalità del dispositivo.
cbmoc
Dimensioni, in byte, della struttura MIDIOUTCAPS . Solo i byte cbMidiOutCaps (o meno) di informazioni vengono copiati nella posizione a cui punta lpMidiOutCaps. Se cbMidiOutCaps è zero, non viene copiato nulla e la funzione restituisce MMSYSERR_NOERROR.
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. |
|
Il puntatore o la struttura specificati non sono validi. |
|
Il driver non è installato. |
|
Il sistema non è in grado di caricare la descrizione della stringa del mapper. |
Commenti
Per determinare il numero di dispositivi di output MIDI presenti nel sistema, utilizzare la funzione midiOutGetNumDevs .
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 (include Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |