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 |
|---|---|
|
Pelo menos um sinalizador é inválido. |
|
Pelo menos um parâmetro é inválido. |
|
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 |