Función acmDriverAddW (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 que se usan para agregar controladores de ACM. Una vez agregado correctamente un controlador, la función de entrada del controlador recibirá mensajes del controlador ACM.

Sintaxis

MMRESULT ACMAPI acmDriverAddW(
  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 la 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 de 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 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 se haya iniciado con 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 impulsores. 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 deben omitirse. ACM_DRIVERADDF_GLOBAL no se puede especificar junto con esta marca. Para obtener más información sobre las prioridades de los controladores, vea la descripción de la función acmDriverPriority .

Valor devuelto

Devuelve cero si es correcto o si se produce un error de lo contrario. 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.

Comentarios

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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
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