funzione MODM_GETNUMDEVS

WINMM invia il MODM_GETNUMDEVS messaggio alla funzione modMessage di un driver di output MIDI per richiedere il numero di dispositivi di output MIDI disponibili.

Sintassi

DWORD modMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwUser,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

Parametri

• uDeviceID
  Specifica l'ID del dispositivo di destinazione. Gli ID dispositivo sono sequenziali e hanno un valore iniziale pari a zero e un valore finale uguale a uno minore del numero di dispositivi supportati dal driver.

• Umsg
  WINMM imposta questo parametro su MODM_GETNUMDEVS quando chiama modMessage per elaborare questo messaggio.

• dwUser
  Usare questo parametro per restituire i dati dell'istanza al driver. I driver che supportano più client possono usare questi dati dell'istanza per tenere traccia del client associato al messaggio.

• dwParam1
  Non usato.

• dwParam2
  Non usato.

Valore restituito

La funzione modMessage restituisce il numero di dispositivi di output MIDI supportati dal driver.

Commenti

I driver possono essere strutturati in diversi modi. I driver più semplici e più comuni usano un dispositivo fisico per supportare un dispositivo logico. I driver possono supportare anche più dispositivi logici usando un singolo dispositivo fisico. Ad esempio, un driver può usare un singolo processore di segnale digitale (DSP) per supportare due diversi tipi di sintetizzatori interni. Tale driver restituirà il valore "2" in risposta al MODM_GETNUMDEVS messaggio.

Requisiti

Vedi anche

ModMessage