Structure ACMFILTERDETAILS (msacm.h)

Article
08/24/2023

La structure ACMFILTERDETAILS détaille un filtre audio de forme d’onde pour une balise de filtre spécifique pour un pilote ACM.

Syntaxe

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

Membres

cbStruct

Taille, en octets, de la structure ACMFILTERDETAILS . Ce membre doit être initialisé avant d’appeler les fonctions acmFilterDetails ou acmFilterEnum . La taille spécifiée dans ce membre doit être suffisamment grande pour contenir la structure ACMFILTERDETAILS de base. Lorsque la fonction acmFilterDetails retourne, ce membre contient la taille réelle des informations retournées. Les informations retournées ne dépasseront jamais la taille demandée.

dwFilterIndex

Index du filtre sur les détails qui seront récupérés. L’index varie de zéro à un de moins que le nombre de filtres standard pris en charge par un pilote ACM pour une balise de filtre. Le nombre de filtres standard pris en charge par un pilote pour une balise de filtre est contenu dans la structure ACMFILTERTAGDETAILS . Le membre dwFilterIndex est utilisé uniquement lors de l’interrogation des détails de filtre standard sur un pilote par index ; sinon, ce membre doit être égal à zéro. En outre, ce membre est défini sur zéro par ACM lorsqu’une application demande des détails sur un filtre ; en d’autres termes, ce membre est utilisé uniquement pour l’entrée et n’est jamais retourné par ACM ou un pilote ACM.

dwFilterTag

Balise de filtre waveform-audio décrite par la structure ACMFILTERDETAILS . Ce membre est utilisé comme entrée pour l’indicateur de requête ACM_FILTERDETAILSF_INDEX. Pour l’indicateur de requête ACM_FILTERDETAILSF_FORMAT, ce membre doit être initialisé sur la même balise de filtre que le membre pwfltr spécifie. Si la fonction acmFilterDetails réussit, ce membre est toujours retourné. Ce membre doit être défini sur WAVE_FILTER_UNKNOWN pour tous les autres indicateurs de requête.

fdwSupport

Indicateurs de prise en charge des pilotes spécifiques au filtre spécifié. Ces indicateurs sont identiques à la structure ACMDRIVERDETAILS , mais ils sont spécifiques au filtre interrogé. Ce membre peut être une combinaison des valeurs suivantes et identifier les opérations que le pilote prend en charge pour 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 du filtre spécifié. Par exemple, si un pilote prend en charge la compression de WAVE_FORMAT_PCM vers WAVE_FORMAT_ADPCM avec le filtre spécifié, 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 le filtre spécifié. Par exemple, si un pilote prend en charge le rééchantillonnage de WAVE_FORMAT_PCM avec le filtre spécifié, 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 le filtre spécifié 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 récupérer les identificateurs de périphérique audio de forme d’onde associés au pilote ACM de prise en charge.

pwfltr

Pointeur vers une structure WAVEFILTER qui recevra les détails du filtre. Cette structure ne nécessite aucune initialisation par l’application, sauf si l’indicateur ACM_FILTERDETAILSF_FILTER est spécifié avec la fonction acmFilterDetails . Dans ce cas, le membre dwFilterTag de la structure WAVEFILTER doit être égal au membre dwFilterTag de la structure ACMFILTERDETAILS .

cbwfltr

Taille, en octets, disponible pour que pwfltr reçoive les détails du filtre. Les fonctions acmMetrics et acmFilterTagDetails peuvent être utilisées pour déterminer la taille maximale requise pour tout filtre disponible pour le pilote spécifié (ou pour tous les pilotes ACM installés).

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

Chaîne qui décrit le filtre pour le type dwFilterTag . Si la fonction acmFilterDetails réussit, cette chaîne est toujours retournée.

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