Fonction de rappel ACMFILTERTAGENUMCB (msacm.h)

  • Article

La fonction acmFilterTagEnumCallback spécifie une fonction de rappel utilisée avec la fonction acmFilterTagEnum . Le nom de la fonction acmFilterTagEnumCallback est un espace réservé pour un nom de fonction défini par l’application.

Syntaxe

ACMFILTERTAGENUMCB Acmfiltertagenumcb;

BOOL Acmfiltertagenumcb(
  HACMDRIVERID hadid,
  LPACMFILTERTAGDETAILS paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Paramètres

hadid

Gérez l’identificateur du pilote ACM.

paftd

Pointeur vers une structure ACMFILTERTAGDETAILS qui contient les détails de la balise de filtre énumérée.

dwInstance

Valeur définie par l’application spécifiée dans acmFilterTagEnum.

fdwSupport

Indicateurs de prise en charge des pilotes spécifiques à la structure ACMDRIVERDETAILS de l’identificateur de pilote. Ce paramètre peut être une combinaison des valeurs suivantes et identifie les opérations que le pilote prend en charge avec la balise de filtre.

Valeur Signification
ACMDRIVERDETAILS_SUPPORTF_ASYNC Le pilote prend en charge les conversions asynchrones avec la balise de filtre spécifiée.
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 lors de l’utilisation de la balise de filtre spécifiée. Par exemple, si un pilote prend en charge le rééchantillonnage de 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 indices 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.

Valeur retournée

La fonction de rappel doit retourner TRUE pour continuer l’énumération ou FALSE pour arrêter l’énumération.

Notes

La fonction acmFilterTagEnum retourne MMSYSERR_NOERROR (zéro) si aucune balise de filtre ne doit être énumérée. En outre, la fonction de rappel n’est pas appelée.

Les fonctions suivantes ne doivent pas être appelées à partir de la fonction de rappel : acmDriverAdd, acmDriverRemove et acmDriverPriority.

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]
Plateforme cible Windows
En-tête msacm.h

Voir aussi

Fonctions de compression audio

Gestionnaire de compression audio