Estrutura ACMFILTERTAGDETAILS (msacm.h)

A estrutura ACMFILTERTAGDETAILS detalha uma marca de filtro de áudio de forma de onda para um driver de filtro do ACM.

Sintaxe

typedef struct tACMFILTERTAGDETAILS {
  DWORD cbStruct;
  DWORD dwFilterTagIndex;
  DWORD dwFilterTag;
  DWORD cbFilterSize;
  DWORD fdwSupport;
  DWORD cStandardFilters;
  char  szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
} ACMFILTERTAGDETAILS, *PACMFILTERTAGDETAILS, *LPACMFILTERTAGDETAILS;

Membros

cbStruct

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

dwFilterTagIndex

Índice da marca de filtro para o qual recuperar detalhes. O índice varia de zero a um a menos do que o número de marcas de filtro compatíveis com um driver ACM. O número de marcas de filtro compatíveis com um driver está contido na estrutura ACMDRIVERDETAILS . O membro dwFilterTagIndex é usado somente ao consultar detalhes da marca de filtro sobre um driver por índice; caso contrário, esse membro deve ser zero.

dwFilterTag

Marca de filtro waveform-audio que a estrutura ACMFILTERTAGDETAILS descreve. Esse membro é usado como uma entrada para os sinalizadores de consulta ACM_FILTERTAGDETAILSF_FILTERTAG e ACM_FILTERTAGDETAILSF_LARGESTSIZE. Esse membro sempre será retornado se a função acmFilterTagDetails for bem-sucedida. Esse membro deve ser definido como WAVE_FILTER_UNKNOWN para todos os outros sinalizadores de consulta.

cbFilterSize

Maior tamanho total, em bytes, de um filtro waveform-audio do tipo dwFilterTag . Por exemplo, esse membro terá 40 para WAVE_FILTER_ECHO e 36 para WAVE_FILTER_VOLUME.

fdwSupport

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

Nome	Descrição
ACMDRIVERDETAILS_SUPPORTF_ASYNC	O driver dá suporte a conversões assíncronas.
ACMDRIVERDETAILS_SUPPORTF_CODEC	O driver dá suporte à conversão entre duas marcas de formato diferentes ao usar a marca de filtro especificada. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM com a marca de filtro especificada, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	O driver dá suporte à conversão entre dois formatos diferentes da mesma marca de formato ao usar a marca de filtro especificada. Por exemplo, se um driver der suporte à ressampling de WAVE_FORMAT_PCM com a marca de filtro especificada, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_FILTER	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 em WAVE_FORMAT_PCM, esse sinalizador será definido.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	O driver dá suporte à entrada, saída ou ambos de hardware com a marca de filtro especificada 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.

cStandardFilters

Número de filtros padrão do tipo dwFilterTag (ou seja, a combinação de todas as características de filtro). Esse valor não pode especificar todos os filtros compatíveis com o driver.

szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS]

Cadeia de caracteres que descreve o tipo dwFilterTag . Essa cadeia de caracteres sempre será retornada se a função acmFilterTagDetails for bem-sucedida.

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

ACMDRIVERDETAILS

Gerenciador de Compactação de Áudio

Estruturas de compactação de áudio

acmFilterTagDetails

acmFilterTagEnum