MODM_RESET función

WINMM envía el MODM_RESET mensaje a la función modMessage de un controlador de salida MIDI para detener la salida de la cola de salida y desactivar las notas que se están reproduciendo.

Sintaxis

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

Parámetros

• uDeviceID
  Especifica el identificador del dispositivo de destino. Los identificadores de dispositivo son secuenciales y tienen un valor inicial de cero y un valor final que es igual a uno menor que el número de dispositivos que admite el controlador.

• uMsg
  WINMM establece este parámetro en MODM_RESET cuando llama a modMessage para procesar este mensaje.

• dwUser
  Use este parámetro para devolver datos de instancia al controlador. Los controladores que admiten varios clientes pueden usar estos datos de instancia para realizar un seguimiento del cliente asociado al mensaje.

• dwParam1
  No se usa.

• dwParam2
  No se usa.

Valor devuelto

La función modMessage devuelve MMSYSERR_NOERROR si la operación se realiza correctamente. De lo contrario, devuelve MMSYSERR_NOTENABLED para indicar que el controlador no se pudo cargar o inicializar.

Comentarios

Si la cola de salida del controlador de salida MIDI no está vacía, debe detener todos los bloques de datos pendientes y marcarlos como se hace estableciendo el bit MHDR_DONE en el campo dwFlags de la estructura MIDIHDR para cada bloque. A continuación, el controlador debe notificar al cliente mediante DriverCallback para enviar un mensaje de MOM_DONE para cada bloque de datos.

Si el dispositivo es un puerto de salida, el controlador debe enviar un evento midi note-off para las 128 notas en todos los 16 canales. Opcionalmente, el controlador puede realizar un seguimiento de las notas que están activadas y enviar eventos de nota desactivada solo para esas notas. Además, el conductor debe enviar un evento "pedal de amortiguación apagado" (controlador 0x40) para cada canal. Si el dispositivo es un sintetizador interno, el controlador debe desactivar las notas que se están reproduciendo.

Requisitos

Plataforma de destino	Escritorio
Versión	Disponible en Windows XP y en sistemas operativos Windows posteriores.
Encabezado	Mmddk.h (incluya Mmddk.h, Mmsystem.h o Windows.h)

Consulte también

modMessage

MIDIHDR

DriverCallback

MOM_DONE