Função acmDriverAddA (msacm.h)

A função acmDriverAdd adiciona um driver à lista de drivers ACM disponíveis. O tipo de driver e o local dependem dos sinalizadores usados para adicionar drivers ACM. Depois que um driver for adicionado com êxito, a função de entrada do driver receberá mensagens de driver do ACM.

Sintaxe

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

Parâmetros

phadid

Ponteiro para o buffer que recebe um identificador que identifica o driver instalado. Esse identificador é usado para identificar o driver em chamadas para outras funções do ACM.

hinstModule

Manipule para a instância do módulo cuja DLL (biblioteca de vínculo dinâmico) ou executável contenha a função de entrada do driver.

lParam

Endereço de função do driver ou um identificador de janela de notificação, dependendo dos sinalizadores fdwAdd .

dwPriority

Mensagem de janela a ser enviada para transmissões de notificação. Esse parâmetro é usado apenas com o sinalizador ACM_DRIVERADDF_NOTIFYHWND. Todos os outros sinalizadores exigem que esse membro seja definido como zero.

fdwAdd

Sinalizadores para adicionar drivers do ACM. Os valores a seguir são definidos.

Valor	Significado
ACM_DRIVERADDF_FUNCTION	O parâmetro lParam é um endereço de função de driver em conformidade com o protótipo acmDriverProc . A função pode residir em um arquivo executável ou DLL.
ACM_DRIVERADDF_GLOBAL	Fornecido para compatibilidade com aplicativos de 16 bits. Para a API Win32, os drivers do ACM adicionados pela função acmDriverAdd só podem ser usados pelo aplicativo que adicionou o driver. Isso é verdade se ACM_DRIVERADDF_GLOBAL está ou não especificado. Para obter mais informações, consulte Adicionando drivers dentro de um aplicativo.
ACM_DRIVERADDF_LOCAL	O ACM dá automaticamente a um driver local prioridade mais alta do que um driver global ao procurar um driver para atender a uma chamada de função. Para obter mais informações, consulte Adicionando drivers dentro de um aplicativo.
ACM_DRIVERADDF_NAME	O parâmetro lParam é um nome de valor do Registro no HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Drivers32. O valor identifica uma DLL que implementa um codec do ACM. Os aplicativos poderão usar esse sinalizador se novas entradas do Registro forem criadas depois que o aplicativo já tiver começado a usar o ACM.
ACM_DRIVERADDF_NOTIFYHWND	O parâmetro lParam é um identificador de uma janela de notificação que recebe mensagens quando são feitas alterações nas prioridades e estados do driver global. A mensagem de janela a ser recebida é definida pelo aplicativo e deve ser passada em dwPriority. Os parâmetros wParam e lParam passados com a mensagem de janela são reservados para uso futuro e devem ser ignorados. ACM_DRIVERADDF_GLOBAL não pode ser especificado em conjunto com esse sinalizador. Para obter mais informações sobre as prioridades do driver, consulte a descrição da função acmDriverPriority .

Retornar valor

Retorna zero se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
MMSYSERR_INVALFLAG	Pelo menos um sinalizador é inválido.
MMSYSERR_INVALPARAM	Pelo menos um parâmetro é inválido.
MMSYSERR_NOMEM	O sistema não pode alocar recursos.

Comentários

Observação

O cabeçalho msacm.h define acmDriverAdd como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msacm.h
Biblioteca	Msacm32.lib
DLL	Msacm32.dll

Confira também

Funções de compactação de áudio

Gerenciador de Compactação de Áudio