función acmDriverAdd (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 acmDriverAdd(
  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

Identificador de 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, en función de las marcas fdwAdd .

dwPriority

Mensaje de ventana que se va a enviar para las difusiones de notificación. 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 valores siguientes.

Valor	Significado
ACM_DRIVERADDF_FUNCTION	El parámetro lParam es una dirección de función del controlador que se ajusta al prototipo 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 la función acmDriverAdd 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, vea 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, vea 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 uso futuro y se deben omitir. ACM_DRIVERADDF_GLOBAL no se puede especificar junto con esta marca. Para obtener más información sobre las prioridades del controlador, vea la descripción de la función acmDriverPriority .

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario. Entre los valores de error posibles 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.

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