Share via

Função acmDriverMessage (msacm.h)

  • Artigo

A função acmDriverMessage envia uma mensagem definida pelo usuário para uma determinada instância de driver do ACM.

Sintaxe

LRESULT ACMAPI acmDriverMessage(
  HACMDRIVER had,
  UINT       uMsg,
  LPARAM     lParam1,
  LPARAM     lParam2
);

Parâmetros

had

Manipule para a instância do driver do ACM para a qual a mensagem será enviada.

uMsg

Mensagem de que o driver do ACM deve processar. Essa mensagem deve estar no intervalo de mensagens ACMDM_USER (acima ou igual a ACMDM_USER e menor que ACMDM_RESERVED_LOW). As exceções a essa restrição são as mensagens ACMDM_DRIVER_ABOUT, DRV_QUERYCONFIGURE e DRV_CONFIGURE .

lParam1

Parâmetro de mensagem.

lParam2

Parâmetro de mensagem.

Valor retornado

O valor retornado é específico para a mensagem de driver do ACM definida pelo usuário especificada pelo parâmetro uMsg. No entanto, os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
MMSYSERR_INVALHANDLE
 O identificador especificado é inválido.
MMSYSERR_INVALPARAM
 O parâmetro uMsg não está no intervalo de ACMDM_USER.
MMSYSERR_NOTSUPPORTED
 O driver do ACM não processou a mensagem.

Comentários

Para exibir uma caixa de diálogo Sobre personalizada de um driver do ACM, um aplicativo deve enviar a mensagem ACMDM_DRIVER_ABOUT para o driver. O parâmetro lParam1 deve ser o identificador da janela proprietário da caixa de diálogo About personalizada e lParam2 deve ser definido como zero. Se o driver não der suporte a uma caixa de diálogo Sobre personalizada, MMSYSERR_NOTSUPPORTED será retornado e será responsabilidade do aplicativo exibir sua própria caixa de diálogo. Por exemplo, a opção Painel de Controle Sound Mapper exibirá uma caixa de diálogo About padrão com base na estrutura ACMDRIVERDETAILS quando um driver do ACM retornar MMSYSERR_NOTSUPPORTED. Um aplicativo pode consultar um driver para obter suporte personalizado da caixa de diálogo Sobre sem que a caixa de diálogo seja exibida definindo lParam1 como –1L. Se o driver der suporte a uma caixa de diálogo Sobre personalizada, MMSYSERR_NOERROR será retornado. Caso contrário, o valor retornado será MMSYSERR_NOTSUPPORTED.

As mensagens definidas pelo usuário devem ser enviadas apenas para um driver ACM que dê suporte especificamente às mensagens. O chamador deve verificar se o driver do ACM é o driver correto recuperando os detalhes do driver e verificando os membros wMid, wPid e vdwDriver da estrutura ACMDRIVERDETAILS .

Nunca envie mensagens definidas pelo usuário para um driver ACM desconhecido.

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