Função acmFormatTagEnum (msacm.h)

A função acmFormatTagEnum enumera marcas de formato waveform-audio disponíveis em um driver do ACM. Essa função continua enumerando até que não haja marcas de formato mais adequadas ou a função de retorno de chamada retorne FALSE.

Sintaxe

MMRESULT ACMAPI acmFormatTagEnum(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  ACMFORMATTAGENUMCB    fnCallback,
  DWORD_PTR             dwInstance,
  DWORD                 fdwEnum
);

Parâmetros

had

Manipule para o driver do ACM para consultar detalhes da marca de formato waveform-audio. Se esse parâmetro for NULL, o ACM usará os detalhes do primeiro driver ACM adequado.

paftd

Ponteiro para a estrutura ACMFORMATTAGDETAILS que deve receber os detalhes da marca de formato passados para a função especificada em fnCallback. Essa estrutura deve ter o membro cbStruct da estrutura ACMFORMATTAGDETAILS inicializado.

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 de 32 bits (DWORD) que é passado para a função de retorno de chamada junto com detalhes da marca de formato ACM.

fdwEnum

Reservados; deve ser zero.

Retornar valor

Retornará zero se tiver êxito ou um erro, caso contrário. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
MMSYSERR_INVALFLAG	Pelo menos um sinalizador é inválido.
MMSYSERR_INVALHANDLE	O identificador especificado é inválido.
MMSYSERR_INVALPARAM	Pelo menos um parâmetro é inválido.

Comentários

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

Requisitos

Requisito	Valor
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