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 |
|---|---|
|
El identificador especificado no es válido. |
|
El parámetro uMsg no está en el intervalo de ACMDM_USER. |
|
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 |