Compartilhar via


Função acmDriverAdd (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 acmDriverAdd(
  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 .

Valor retornado

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.

Requisitos

   
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