Estrutura ACMFORMATTAGDETAILS (msacm.h)
A estrutura ACMFORMATTAGDETAILS detalha uma marca de formato de áudio de forma de onda para um driver do ACM.
Sintaxe
typedef struct tACMFORMATTAGDETAILS {
DWORD cbStruct;
DWORD dwFormatTagIndex;
DWORD dwFormatTag;
DWORD cbFormatSize;
DWORD fdwSupport;
DWORD cStandardFormats;
char szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;
Membros
cbStruct
Tamanho, em bytes, da estrutura ACMFORMATTAGDETAILS . Esse membro deve ser inicializado antes que um aplicativo chame a função acmFormatTagDetails ou acmFormatTagEnum . O tamanho especificado por esse membro deve ser grande o suficiente para conter a estrutura base ACMFORMATTAGDETAILS . Quando a função acmFormatTagDetails retorna, esse membro contém o tamanho real das informações retornadas. As informações retornadas nunca excederão o tamanho solicitado.
dwFormatTagIndex
Índice da marca de formato para a qual os detalhes serão recuperados. O índice varia de zero a um a menos do que o número de marcas de formato compatíveis com um driver do ACM. O número de marcas de formato com suporte de um driver está contido na estrutura ACMDRIVERDETAILS . O membro dwFormatTagIndex é usado somente ao consultar detalhes da marca de formato em um driver por índice; caso contrário, esse membro deve ser zero.
dwFormatTag
Marca de formato waveform-audio que a estrutura ACMFORMATTAGDETAILS descreve. Esse membro é usado para entrada para os sinalizadores de consulta ACM_FORMATTAGDETAILSF_FORMATTAG e ACM_FORMATTAGDETAILSF_LARGESTSIZE. Se a função acmFormatTagDetails for bem-sucedida, esse membro sempre será retornado. Esse membro deve ser definido como WAVE_FORMAT_UNKNOWN para todos os outros sinalizadores de consulta.
cbFormatSize
Maior tamanho total, em bytes, de um formato waveform-audio do tipo dwFormatTag . Por exemplo, esse membro será 16 para WAVE_FORMAT_PCM e 50 para WAVE_FORMAT_ADPCM.
fdwSupport
Sinalizadores de suporte ao driver específicos para a marca de formato. Esses sinalizadores são idênticos à estrutura ACMDRIVERDETAILS . Esse membro pode ser uma combinação dos seguintes valores e se referir a quais operações o driver dá suporte com a marca de formato:
| Nome | Descrição |
|---|---|
|
O driver dá suporte a conversões assíncronas com a marca de formato especificada. |
|
O driver dá suporte à conversão entre duas marcas de formato diferentes em que uma das marcas é a marca de formato especificada. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM, esse sinalizador será definido. |
|
O driver dá suporte à conversão entre dois formatos diferentes da marca de formato especificada. Por exemplo, se um driver der suporte à resampação de WAVE_FORMAT_PCM, esse sinalizador será definido. |
|
O driver dá suporte a um filtro (modificação dos dados sem alterar nenhum dos atributos de formato). Por exemplo, se um driver der suporte a operações de volume ou eco na marca de formato especificada, esse sinalizador será definido. |
|
O driver dá suporte à entrada de hardware, à saída ou a ambas as marcas de formato especificadas por meio de um dispositivo de áudio de forma de onda. Um aplicativo deve usar a função 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. |
cStandardFormats
Número de formatos padrão do tipo dwFormatTag ; ou seja, a combinação de todas as taxas de exemplo, bits por exemplo, canais e assim por diante. Esse valor pode especificar todos os formatos compatíveis com o driver, mas não necessariamente.
szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]
Cadeia de caracteres que descreve o tipo dwFormatTag . Se a função acmFormatTagDetails for bem-sucedida, essa cadeia de caracteres sempre será retornada.
Requisitos
| 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 |
Confira também
Gerenciador de Compactação de Áudio