función acmDriverAddA (msacm.h)

La función acmDriverAdd agrega un controlador a la lista de controladores ACM disponibles. El tipo de controlador y la ubicación dependen de las marcas usadas para agregar controladores ACM. Una vez agregado correctamente un controlador, la función de entrada del controlador recibirá mensajes del controlador ACM.

Sintaxis

MMRESULT ACMAPI acmDriverAddA(
  LPHACMDRIVERID phadid,
  HINSTANCE      hinstModule,
  LPARAM         lParam,
  DWORD          dwPriority,
  DWORD          fdwAdd
);

Parámetros

phadid

Puntero al búfer que recibe un identificador que identifica el controlador instalado. Este identificador se usa para identificar el controlador en llamadas a otras funciones de ACM.

hinstModule

Controle a la instancia del módulo cuyo archivo ejecutable o biblioteca de vínculos dinámicos (DLL) contiene la función de entrada del controlador.

lParam

Dirección de función del controlador o un identificador de ventana de notificación, según las marcas de fdwAdd .

dwPriority

Mensaje de ventana que se va a enviar para las difusión de notificaciones. Este parámetro solo se usa con la marca ACM_DRIVERADDF_NOTIFYHWND. Todas las demás marcas requieren que este miembro se establezca en cero.

fdwAdd

Marcas para agregar controladores de ACM. Se definen los siguientes valores.

Valor	Significado
ACM_DRIVERADDF_FUNCTION	El parámetro lParam es una dirección de función de controlador que se ajusta al prototipo de acmDriverProc. La función puede residir en un archivo ejecutable o DLL.
ACM_DRIVERADDF_GLOBAL	Se proporciona para la compatibilidad con aplicaciones de 16 bits. Para la API de Win32, los controladores ACM agregados por el acmDriverAdd función solo se pueden usar en la aplicación que agregó el controlador. Esto es cierto si se especifica o no ACM_DRIVERADDF_GLOBAL. Para obtener más información, consulte Agregar controladores dentro de una aplicación.
ACM_DRIVERADDF_LOCAL	El ACM proporciona automáticamente una prioridad más alta al controlador local que un controlador global al buscar un controlador para satisfacer una llamada de función. Para obtener más información, consulte Agregar controladores dentro de una aplicación.
ACM_DRIVERADDF_NAME	El parámetro lParam es un nombre de valor del Registro en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Drivers32. El valor identifica un archivo DLL que implementa un códec ACM. Las aplicaciones pueden usar esta marca si se crean nuevas entradas del Registro después de que la aplicación ya haya empezado a usar ACM.
ACM_DRIVERADDF_NOTIFYHWND	El parámetro lParam es un identificador de una ventana de notificación que recibe mensajes cuando se realizan cambios en las prioridades y estados globales de los controladores. La aplicación define el mensaje de ventana que se va a recibir y se debe pasar en dwPriority. Los parámetros wParam y lParam pasados con el mensaje de ventana están reservados para su uso futuro y deben omitirse. ACM_DRIVERADDF_GLOBAL no se puede especificar junto con esta marca. Para obtener más información sobre las prioridades del controlador, consulte la descripción de la función acmDriverPriority.

Valor devuelto

Devuelve cero si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.

Código devuelto	Descripción
MMSYSERR_INVALFLAG	Al menos una marca no es válida.
MMSYSERR_INVALPARAM	Al menos un parámetro no es válido.
MMSYSERR_NOMEM	El sistema no puede asignar recursos.

Observaciones

Nota

El encabezado msacm.h define acmDriverAdd como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	msacm.h
biblioteca de	Msacm32.lib
DLL de	Msacm32.dll

Consulte también

funciones de compresión de audio de

administrador de compresión de audio