função acmFormatDetailsW (msacm.h)

Artigo
11/20/2024

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

Sintaxe

MMRESULT ACMAPI acmFormatDetailsW(
  HACMDRIVER          had,
  LPACMFORMATDETAILSW pafd,
  DWORD               fdwDetails
);

Parâmetros

had

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

pafd

Ponteiro para uma estrutura ACMFORMATDETAILS para conter os detalhes do formato da marca de formato fornecida.

fdwDetails

Sinalizadores para obter os detalhes da marca de formato waveform-audio. Os valores a seguir são definidos.

[ACMFORMATDETAILS]A estrutura (./nf-msacm-acmformatdetails.md) foi fornecida e os detalhes restantes devem ser retornados. O dwFormatTag membro da estrutura deACMFORMATDETAILS deve ser inicializado para a mesma marca de formato especificada pwfx. Esse tipo de consulta pode ser usado para obter uma descrição de cadeia de caracteres de uma estrutura de formato arbitrário. Se um aplicativo especificar um identificador de driver ACM para tiver, os detalhes sobre o 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.

Valor	Significado
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Um índice de formato para a marca de formato foi fornecido no membro dwFormatIndex da estrutura de ACMFORMATDETAILS. Os detalhes do formato serão retornados na estrutura definida por pafd. O índice varia de zero a um a menos do que o cStandardFormats membro retornado na estrutura de ACMFORMATTAGDETAILS para uma marca de formato. Um aplicativo deve especificar um identificador de driver para teve ao recuperar detalhes de formato com esse sinalizador. Para obter informações sobre quais membros devem ser inicializados antes de chamar essa função, consulte a estrutura ACMFORMATDETAILS.

Valor

Significado

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Um índice de formato para a marca de formato foi fornecido no membro dwFormatIndex da estrutura de ACMFORMATDETAILS. Os detalhes do formato serão retornados na estrutura definida por pafd. O índice varia de zero a um a menos do que o cStandardFormats membro retornado na estrutura de ACMFORMATTAGDETAILS para uma marca de formato. Um aplicativo deve especificar um identificador de driver para teve ao recuperar detalhes de formato com esse sinalizador. Para obter informações sobre quais membros devem ser inicializados antes de chamar essa função, consulte a estrutura ACMFORMATDETAILS.

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 ACMFORMATDETAILS 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