função acmFormatTagDetailsW (msacm.h)

Artigo
11/20/2024

A função acmFormatTagDetails consulta o ACM para obter detalhes sobre uma marca de formato de áudio de forma de onda específica.

Sintaxe

MMRESULT ACMAPI acmFormatTagDetailsW(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSW paftd,
  DWORD                  fdwDetails
);

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. Um aplicativo deve especificar um identificador de driver ou identificador válido ao usar o tipo de consulta ACM_FORMATTAGDETAILSF_INDEX. Identificadores de driver para drivers desabilitados não são permitidos.

paftd

Ponteiro para a estrutura de ACMFORMATTAGDETAILS que deve receber os detalhes da marca de formato.

fdwDetails

Sinalizadores para obter os detalhes. Os valores a seguir são definidos.

[ACMFORMATTAGDETAILS]Estrutura (./nf-msacm-acmformattagdetails.md). Os detalhes da marca de formato serão retornados na estrutura apontada por paftd. Se um aplicativo especificar um identificador de driver ACM para tiver, os detalhes sobre a marca de formato serão retornados para esse driver. Se um aplicativo especificar NULL para , o ACM encontrará o primeiro driver aceitável para retornar os detalhes. [ACMDRIVERDETAILS]Estrutura (./nf-msacm-acmdriverdetails.md) para um driver ACM. Um aplicativo deve especificar um identificador de driver para teve ao recuperar detalhes da marca de formato com esse sinalizador. [ACMFORMATTAGDETAILS]A estrutura (./nf-msacm-acmformattagdetails.md) deve ser WAVE_FORMAT_UNKNOWN ou a marca de formato para a qual encontrar o maior tamanho. Se um aplicativo especificar um identificador de driver do ACM para tiver, os detalhes sobre a maior marca de formato serão retornados para esse driver. Se um aplicativo especificar NULL para , o ACM encontrará um driver aceitável com a maior marca de formato solicitada para retornar os detalhes.

Valor	Significado
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

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
ACMERR_NOTPOSSIBLE	Os detalhes solicitados não estão disponíveis.
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

Nota

O cabeçalho msacm.h define ACMFORMATTAGDETAILS 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