função acmFormatTagEnumW (msacm.h)

Artigo
11/20/2024

A função acmFormatTagEnum enumera marcas de formato waveform-audio disponíveis em um driver 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 acmFormatTagEnumW(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSW paftd,
  ACMFORMATTAGENUMCBW    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 de ACMFORMATTAGDETAILS que deve receber os detalhes da marca de formato passados para a função especificada em fnCallback. Essa estrutura deve ter o cbStruct membro da estrutura ACMFORMATTAGDETAILS inicializada.

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 os detalhes da marca de formato ACM.

fdwEnum

Reservado; deve ser zero.

Valor de retorno

Retornará 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_INVALHANDLE	O identificador especificado é inválido.
MMSYSERR_INVALPARAM	Pelo menos um parâmetro é inválido.

Observações

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

Nota

O cabeçalho msacm.h define acmFormatTagEnum como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	msacm.h
biblioteca	Msacm32.lib
de DLL	Msacm32.dll

Consulte também

Funções de compactação de áudio

do Gerenciador de Compactação de Áudio

Compartilhar via