Structure ACMFILTERTAGDETAILS (msacm.h)

La structure ACMFILTERTAGDETAILS détaille une balise de filtre waveform-audio pour un pilote de filtre ACM.

Syntaxe

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

Membres

cbStruct

Taille, en octets, de la structure ACMFILTERTAGDETAILS . Ce membre doit être initialisé avant qu’une application appelle la fonction acmFilterTagDetails ou acmFilterTagEnum . La taille spécifiée dans ce membre doit être suffisamment grande pour contenir la structure ACMFILTERTAGDETAILS de base. Lorsque la fonction acmFilterTagDetails est retournée, ce membre contient la taille réelle des informations retournées. Les informations retournées ne dépasseront jamais la taille demandée.

dwFilterTagIndex

Index de la balise de filtre pour laquelle récupérer des détails. L’index varie de zéro à un inférieur au nombre de balises de filtre prises en charge par un pilote ACM. Le nombre de balises de filtre prises en charge par un pilote est contenu dans la structure ACMDRIVERDETAILS . Le membre dwFilterTagIndex est utilisé uniquement lors de l’interrogation des détails de balise de filtre sur un pilote par index ; sinon, ce membre doit être égal à zéro.

dwFilterTag

Balise de filtre waveform-audio décrite par la structure ACMFILTERTAGDETAILS . Ce membre est utilisé comme entrée pour les indicateurs de requête ACM_FILTERTAGDETAILSF_FILTERTAG et ACM_FILTERTAGDETAILSF_LARGESTSIZE. Ce membre est toujours retourné si la fonction acmFilterTagDetails réussit. Ce membre doit être défini sur WAVE_FILTER_UNKNOWN pour tous les autres indicateurs de requête.

cbFilterSize

Taille totale la plus grande, en octets, d’un filtre audio de forme d’onde du type dwFilterTag . Par exemple, ce membre sera 40 pour WAVE_FILTER_ECHO et 36 pour WAVE_FILTER_VOLUME.

fdwSupport

Indicateurs de prise en charge des pilotes spécifiques à la balise de filtre. Ces indicateurs sont identiques à la structure ACMDRIVERDETAILS . Ce membre peut être une combinaison des valeurs suivantes et identifier les opérations que le pilote prend en charge avec la balise de filtre :

Nom	Description
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Le pilote prend en charge les conversions asynchrones.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Le pilote prend en charge la conversion entre deux balises de format différentes lors de l’utilisation de la balise de filtre spécifiée. Par exemple, si un pilote prend en charge la compression de WAVE_FORMAT_PCM vers WAVE_FORMAT_ADPCM avec la balise de filtre spécifiée, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Le pilote prend en charge la conversion entre deux formats différents de la même balise de format tout en utilisant la balise de filtre spécifiée. Par exemple, si un pilote prend en charge le rééchantillonnage d’WAVE_FORMAT_PCM avec la balise de filtre spécifiée, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Le pilote prend en charge un filtre (modification des données sans modifier les attributs de format). Par exemple, si un pilote prend en charge les opérations de volume ou d’écho sur WAVE_FORMAT_PCM, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Le pilote prend en charge l’entrée matérielle, la sortie ou les deux avec la balise de filtre spécifiée via un périphérique audio de forme d’onde. Une application doit utiliser la fonction acmMetrics avec les index de métrique ACM_METRIC_HARDWARE_WAVE_INPUT et ACM_METRIC_HARDWARE_WAVE_OUTPUT pour obtenir les identificateurs de périphérique audio de forme d’onde associés au pilote ACM de prise en charge.

cStandardFilters

Nombre de filtres standard du type dwFilterTag (c’est-à-dire la combinaison de toutes les caractéristiques de filtre). Cette valeur ne peut pas spécifier tous les filtres pris en charge par le pilote.

szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS]

Chaîne qui décrit le type dwFilterTag . Cette chaîne est toujours retournée si la fonction acmFilterTagDetails réussit.

Spécifications

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	msacm.h

Voir aussi

ACMDRIVERDETAILS

Gestionnaire de compression audio

Audio Compression Structures

acmFilterTagDetails

acmFilterTagEnum