função acmDriverAddA (msacm.h)

Artigo
11/20/2024

A função acmDriverAdd adiciona um driver à lista de drivers ACM disponíveis. O tipo de driver e a localização 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 de driver ou um identificador de janela de notificação, dependendo dos sinalizadores de do 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 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 em umde aplicativo.
ACM_DRIVERADDF_LOCAL	O ACM dá automaticamente a um driver local prioridade maior 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 em umde aplicativo.
ACM_DRIVERADDF_NAME	O parâmetro lParam é um nome de valor do registro em 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 globais do driver. A mensagem de janela a ser recebida é definida pelo aplicativo e deve ser passada 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 de retorno

Retornará 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.

Observações

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	msacm.h
biblioteca	Msacm32.lib
de DLL	Msacm32.dll

Consulte também

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

do Gerenciador de Compactação de Áudio

Compartilhar via