Compartilhar via

Função acmDriverEnum (msacm.h)

  • Artigo

A função acmDriverEnum enumera os drivers ACM disponíveis, continuando até que não haja mais drivers ou a função de retorno de chamada retorne FALSE.

Sintaxe

MMRESULT ACMAPI acmDriverEnum(
  ACMDRIVERENUMCB fnCallback,
  DWORD_PTR       dwInstance,
  DWORD           fdwEnum
);

Parâmetros

fnCallback

Endereço da instância de procedimento da função de retorno de chamada definida pelo aplicativo.

dwInstance

Um valor definido pelo aplicativo de 64 bits (DWORD_PTR) ou DWORD (32 bits) que é passado para a função de retorno de chamada junto com as informações do driver do ACM.

fdwEnum

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

Valor Significado
ACM_DRIVERENUMF_DISABLED Os drivers ACM desabilitados devem ser incluídos na enumeração . Os drivers podem ser desabilitados pelo usuário por meio do Painel de Controle ou por um aplicativo usando a função acmDriverPriority. Se um driver estiver desabilitado, o parâmetro fdwSupport para a função de retorno de chamada terá o sinalizador ACMDRIVERDETAILS_SUPPORTF_DISABLED definido.
ACM_DRIVERENUMF_NOLOCAL Somente os drivers globais devem ser incluídos na enumeração.

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.

Comentários

A função acmDriverEnum retornará MMSYSERR_NOERROR (zero) se nenhum drivers ACM estiver instalado. Além disso, a função de retorno de chamada não será chamada.

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