Funzione midiOutGetDevCapsA (mmeapi.h)

Articolo
11/20/2024

La funzione midiOutGetDevCaps esegue una query su un dispositivo di output MIDI specificato per determinarne le funzionalità.

Sintassi

MMRESULT midiOutGetDevCapsA(
  UINT_PTR       uDeviceID,
  LPMIDIOUTCAPSA 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 cbMidiOutCaps byte (o meno) di informazioni viene copiato nella posizione a cui punta lpMidiOutCaps. Se cbMidiOutCaps è zero, non viene copiato alcun elemento e la funzione restituisce MMSYSERR_NOERROR.

Valore restituito

Restituisce MMSYSERR_NOERROR in caso di esito positivo o di errore. I possibili valori di errore includono quanto segue.

Codice restituito	Descrizione
MMSYSERR_BADDEVICEID	L'identificatore di 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.

Osservazioni

Per determinare il numero di dispositivi di output MIDI presenti nel sistema, utilizzare la funzione midiOutGetNumDevs .

Nota

L'intestazione mmeapi.h definisce midiOutGetDevCaps 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	mmeapi.h (include Windows.h)
libreria	Winmm.lib
dll	Winmm.dll

Vedere anche

funzioni MIDI

Condividi tramite