funzione MODM_RESET

WINMM invia il MODM_RESET messaggio alla funzione modMessage di un driver di output MIDI per arrestare l'output dalla coda di output e disattivare le note riprodotte.

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_RESET 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 di istanza per tenere traccia del client associato al messaggio.

• dwParam1
  Non usato.

• dwParam2
  Non usato.

Valore restituito

La funzione modMessage restituisce MMSYSERR_NOERROR se l'operazione ha esito positivo. In caso contrario, restituisce MMSYSERR_NOTENABLED per indicare che il driver non è riuscito a caricare o inizializzare.

Commenti

Se la coda di output del driver di output MIDI non è vuota, deve arrestare tutti i blocchi di dati in sospeso e contrassegnarli come fatto impostando il bit MHDR_DONE nel campo dwFlags della struttura MIDIHDR per ogni blocco. Il driver deve quindi inviare una notifica al client usando DriverCallback per inviare un messaggio MOM_DONE per ogni blocco di dati.

Se il dispositivo è una porta di output, il driver deve inviare un evento note-off MIDI per tutti i 128 note su tutti i 16 canali. Facoltativamente, il driver può tenere traccia delle note attivate e inviare eventi di blocco note solo per tali note. Inoltre, il driver deve inviare un evento "pedale damper off" (controller 0x40) per ogni canale. Se il dispositivo è un sintetizzatore interno, il driver deve disattivare tutte le note riprodotte.

Requisiti

Vedi anche

modMessage

MIDIHDR

DriverCallback

MOM_DONE