Estrutura ACMFILTERDETAILS (msacm.h)

Artigo
03/15/2023

A estrutura ACMFILTERDETAILS detalha um filtro de áudio de forma de onda para uma marca de filtro específica para um driver ACM.

Sintaxe

typedef struct tACMFILTERDETAILS {
  DWORD        cbStruct;
  DWORD        dwFilterIndex;
  DWORD        dwFilterTag;
  DWORD        fdwSupport;
  LPWAVEFILTER pwfltr;
  DWORD        cbwfltr;
  char         szFilter[ACMFILTERDETAILS_FILTER_CHARS];
} ACMFILTERDETAILS, *PACMFILTERDETAILS, *LPACMFILTERDETAILS;

Membros

cbStruct

Tamanho, em bytes, da estrutura ACMFILTERDETAILS . Esse membro deve ser inicializado antes de chamar as funções acmFilterDetails ou acmFilterEnum . O tamanho especificado neste membro deve ser grande o suficiente para conter a estrutura base ACMFILTERDETAILS . Quando a função acmFilterDetails retorna, esse membro contém o tamanho real das informações retornadas. As informações retornadas nunca excederão o tamanho solicitado.

dwFilterIndex

Índice do filtro sobre quais detalhes serão recuperados. O índice varia de zero a um a menos do que o número de filtros padrão compatíveis com um driver ACM para uma marca de filtro. O número de filtros padrão com suporte por um driver para uma marca de filtro está contido na estrutura ACMFILTERTAGDETAILS . O membro dwFilterIndex é usado somente ao consultar detalhes de filtro 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 em um filtro; em outras palavras, esse membro é usado apenas para entrada e nunca é retornado pelo driver ACM ou ACM.

dwFilterTag

Marca de filtro waveform-audio que a estrutura ACMFILTERDETAILS descreve. Esse membro é usado como uma entrada para o sinalizador de consulta ACM_FILTERDETAILSF_INDEX. Para o sinalizador de consulta ACM_FILTERDETAILSF_FORMAT, esse membro deve ser inicializado para a mesma marca de filtro especificada pelo membro pwfltr . Se a função acmFilterDetails for bem-sucedida, esse membro sempre será retornado. Esse membro deve ser definido como WAVE_FILTER_UNKNOWN para todos os outros sinalizadores de consulta.

fdwSupport

Sinalizadores de suporte ao driver específicos para o filtro especificado. Esses sinalizadores são idênticos à estrutura ACMDRIVERDETAILS , mas são específicos para o filtro que está sendo consultado. Esse membro pode ser uma combinação dos seguintes valores e identifica quais operações o driver dá suporte para 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 o filtro especificado. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM com o filtro 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 filtro especificado. Por exemplo, se um driver der suporte à ressampling de WAVE_FORMAT_PCM com o filtro especificado, 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 o filtro especificado 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 recuperar os identificadores de dispositivo de áudio de forma de onda associados ao driver ACM de suporte.

pwfltr

Ponteiro para uma estrutura WAVEFILTER que receberá os detalhes do filtro. Essa estrutura não requer nenhuma inicialização pelo aplicativo, a menos que o sinalizador ACM_FILTERDETAILSF_FILTER seja especificado com a função acmFilterDetails . Nesse caso, o membro dwFilterTag da estrutura WAVEFILTER deve ser igual ao membro dwFilterTag da estrutura ACMFILTERDETAILS .

cbwfltr

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

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

Cadeia de caracteres que descreve o filtro para o tipo dwFilterTag . Se a função acmFilterDetails 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