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 |
|---|---|
|
Pelo menos um sinalizador é inválido. |
|
O identificador especificado é inválido. |
|
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 |