Función acmDriverMessage (msacm.h)

La función acmDriverMessage envía un mensaje definido por el usuario a una instancia de controlador ACM determinada.

Sintaxis

LRESULT ACMAPI acmDriverMessage(
  HACMDRIVER had,
  UINT       uMsg,
  LPARAM     lParam1,
  LPARAM     lParam2
);

Parámetros

had

Identificador de la instancia del controlador ACM a la que se enviará el mensaje.

uMsg

Mensaje que el controlador ACM debe procesar. Este mensaje debe estar en el intervalo de mensajes ACMDM_USER (superior o igual a ACMDM_USER y menor que ACMDM_RESERVED_LOW). Las excepciones a esta restricción son los mensajes ACMDM_DRIVER_ABOUT, DRV_QUERYCONFIGURE y DRV_CONFIGURE .

lParam1

Parámetro de mensaje.

lParam2

Parámetro de mensaje.

Valor devuelto

El valor devuelto es específico del mensaje del controlador ACM definido por el usuario especificado por el parámetro uMsg. Sin embargo, los posibles valores de error incluyen lo siguiente.

Código devuelto	Descripción
MMSYSERR_INVALHANDLE	El identificador especificado no es válido.
MMSYSERR_INVALPARAM	El parámetro uMsg no está en el intervalo de ACMDM_USER.
MMSYSERR_NOTSUPPORTED	El controlador ACM no procesó el mensaje.

Comentarios

Para mostrar un cuadro de diálogo Acerca de personalizado desde un controlador ACM, una aplicación debe enviar el mensaje ACMDM_DRIVER_ABOUT al controlador. El parámetro lParam1 debe ser el identificador de la ventana de propietario para el cuadro de diálogo About personalizado y lParam2 debe establecerse en cero. Si el controlador no admite un cuadro de diálogo Acerca de personalizado, se devolverá MMSYSERR_NOTSUPPORTED y es responsabilidad de la aplicación mostrar su propio cuadro de diálogo. Por ejemplo, la opción asignador de sonido de Panel de control mostrará un cuadro de diálogo Predeterminado Acerca de según la estructura ACMDRIVERDETAILS cuando un controlador ACM devuelva MMSYSERR_NOTSUPPORTED. Una aplicación puede consultar un controlador para obtener compatibilidad personalizada con el cuadro de diálogo Acerca de sin que se muestre el cuadro de diálogo estableciendo lParam1 en –1L. Si el controlador admite un cuadro de diálogo Acerca de personalizado, se devolverá MMSYSERR_NOERROR. De lo contrario, el valor devuelto es MMSYSERR_NOTSUPPORTED.

Los mensajes definidos por el usuario solo se deben enviar a un controlador ACM que admita específicamente los mensajes. El autor de la llamada debe comprobar que el controlador ACM es el controlador correcto recuperando los detalles del controlador y comprobando los miembros wMid, wPid y vdwDriver de la estructura ACMDRIVERDETAILS .

Nunca envíe mensajes definidos por el usuario a un controlador ACM desconocido.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msacm.h
Library	Msacm32.lib
Archivo DLL	Msacm32.dll

Consulte también

Funciones de compresión de audio

Administrador de compresión de audio