funzione midiInGetDevCapsW (mmeapi.h)

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

Sintassi

MMRESULT midiInGetDevCapsW(
  UINT_PTR      uDeviceID,
  LPMIDIINCAPSW pmic,
  UINT          cbmic
);

Parametri

uDeviceID

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

pmic

Puntatore a una struttura MIDIINCAPS compilata con informazioni sulle funzionalità del dispositivo.

cbmic

Dimensioni, in byte, della struttura MIDIINCAPS . Solo cbMidiInCaps byte (o meno) di informazioni vengono copiate nella posizione a cui punta lpMidiInCaps. Se cbMidiInCaps è zero, non viene copiato nulla e la funzione restituisce MMSYSERR_NOERROR.

Valore restituito

Restituisce MMSYSERR_NOERROR se ha 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 è valido.
MMSYSERR_NODRIVER
Il driver non è installato.
MMSYSERR_NOMEM
Il sistema non è in grado di allocare o bloccare la memoria.

Commenti

Per determinare il numero di dispositivi di input MIDI presenti nel sistema, usare 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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 (includere Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Funzioni MIDI