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 |
---|---|
|
Al menos una marca no es válida. |
|
Al menos un parámetro no es válido. |
|
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 |