Funzione midiInGetDevCapsA (mmeapi.h)

Articolo
11/20/2024

La funzione midiInGetDevCaps determina le funzionalità di un dispositivo di input MIDI specificato.

Sintassi

MMRESULT midiInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPMIDIINCAPSA pmic,
  UINT          cbmic
);

Parametri

uDeviceID

Identificatore del dispositivo di input MIDI. L'identificatore del dispositivo varia da zero a uno minore del numero di dispositivi presenti. Questo parametro può anche essere un handle del dispositivo di cast corretto.

pmic

Puntatore a una struttura MIDIINCAPS piena di informazioni sulle funzionalità del dispositivo.

cbmic

Dimensioni, in byte, della struttura MIDIINCAPS . Solo cbMidiInCaps byte (o meno) di informazioni viene copiato nella posizione a cui punta lpMidiInCaps. Se cbMidiInCaps è 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 allocare o bloccare la memoria.

Osservazioni

Per determinare il numero di dispositivi di input MIDI presenti nel sistema, utilizzare la funzione midiInGetNumDevs .

Nota

L'intestazione mmeapi.h definisce midiInGetDevCaps 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