Estrutura ACMFILTERDETAILS (msacm.h)
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 |
---|---|
|
O driver dá suporte a conversões assíncronas. |
|
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. |
|
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. |
|
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. |
|
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 |
Confira também
Gerenciador de Compactação de Áudio