Estrutura ACMFORMATDETAILS (msacm.h)

Artigo
03/15/2023

A estrutura ACMFORMATDETAILS detalha um formato waveform-audio para uma marca de formato específica para um driver do ACM.

Sintaxe

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

Membros

cbStruct

Tamanho, em bytes, da estrutura ACMFORMATDETAILS . Esse membro deve ser inicializado antes que um aplicativo chame a função acmFormatDetails ou acmFormatEnum . O tamanho especificado por esse membro deve ser grande o suficiente para conter a estrutura base ACMFORMATDETAILS . Quando a função acmFormatDetails retorna, esse membro contém o tamanho real das informações retornadas. As informações retornadas nunca excederão o tamanho solicitado.

dwFormatIndex

Índice do formato para o qual recuperar detalhes. O índice varia de zero a um a menos do que o número de formatos padrão compatíveis com um driver ACM para uma marca de formato. O número de formatos padrão com suporte de um driver para uma marca de formato está contido na estrutura ACMFORMATTAGDETAILS . O membro dwFormatIndex é usado somente quando um aplicativo consulta detalhes de formato padrão sobre um driver por índice; caso contrário, esse membro deve ser zero. Além disso, esse membro será definido como zero pelo ACM quando um aplicativo consultar detalhes sobre um formato; em outras palavras, esse membro é usado apenas para entrada e nunca é retornado pelo driver ACM ou ACM.

dwFormatTag

Marca de formato waveform-audio que a estrutura ACMFORMATDETAILS descreve. Esse membro é usado para entrada para o sinalizador de consulta ACM_FORMATDETAILSF_INDEX. Para o sinalizador de consulta ACM_FORMATDETAILSF_FORMAT, esse membro deve ser inicializado para a mesma marca de formato especificada pelo membro pwfx . Se uma chamada para a função acmFormatDetails for bem-sucedida, esse membro sempre será retornado. Esse membro deve ser definido como WAVE_FORMAT_UNKNOWN para todos os outros sinalizadores de consulta.

fdwSupport

Sinalizadores de suporte de driver específicos para o formato especificado. Esses sinalizadores são idênticos à estrutura ACMDRIVERDETAILS . Esse membro pode ser uma combinação dos seguintes valores e indica quais operações o driver dá suporte para a marca de formato:

Nome	Descrição
ACMDRIVERDETAILS_SUPPORTF_ASYNC	O driver dá suporte a conversões assíncronas com a marca de formato especificada.
ACMDRIVERDETAILS_SUPPORTF_CODEC	O driver dá suporte à conversão entre duas marcas de formato diferentes para o formato especificado. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM com o formato especificado, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	O driver dá suporte à conversão entre dois formatos diferentes da mesma marca de formato ao usar o formato especificado. Por exemplo, se um driver der suporte à reexampção de WAVE_FORMAT_PCM para o formato especificado, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_FILTER	O driver dá suporte a um filtro (que modifica dados sem alterar nenhum atributo de formato) com o formato especificado. Por exemplo, se um driver der suporte a operações de volume ou eco em WAVE_FORMAT_PCM, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	O driver dá suporte à entrada de hardware e/ou à saída do formato especificado por meio de um dispositivo de áudio de forma de onda. Um aplicativo deve usar acmMetrics com os índices de métrica ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT para obter os identificadores de dispositivo waveform-audio associados ao driver ACM de suporte.

pwfx

Ponteiro para uma estrutura WAVEFORMATEX que receberá os detalhes do formato. Essa estrutura não requer nenhuma inicialização pelo aplicativo, a menos que o sinalizador ACM_FORMATDETAILSF_FORMAT seja especificado na função acmFormatDetails . Nesse caso, o membro wFormatTag da estrutura WAVEFORMATEX deve ser igual ao dwFormatTag da estrutura ACMFORMATDETAILS .

cbwfx

Tamanho, em bytes, disponível para pwfx receber os detalhes do formato. As funções acmMetrics e acmFormatTagDetails podem ser usadas para determinar o tamanho máximo necessário para qualquer formato disponível para o driver especificado (ou para todos os drivers ACM instalados).

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

Cadeia de caracteres que descreve o formato do tipo dwFormatTag . Se a função acmFormatDetails for bem-sucedida, essa cadeia de caracteres sempre será retornada.

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]
Cabeçalho	msacm.h