Funzione midiOutGetDevCaps (mmeapi.h)

  • Articolo

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
MMSYSERR_BADDEVICEID
 L'identificatore del dispositivo specificato non è compreso nell'intervallo.
MMSYSERR_INVALPARAM
 Il puntatore o la struttura specificati non sono validi.
MMSYSERR_NODRIVER
 Il driver non è installato.
MMSYSERR_NOMEM
 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

Vedi anche

Funzioni MIDI