Fonction de rappel ACMFORMATTAGENUMCBA (msacm.h)

Article
11/20/2024

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

Syntaxe

ACMFORMATTAGENUMCBA Acmformattagenumcba;

BOOL Acmformattagenumcba(
  HACMDRIVERID hadid,
  LPACMFORMATTAGDETAILSA paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Paramètres

hadid

Gérer l’identificateur du pilote ACM.

paftd

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

dwInstance

Valeur définie par l’application spécifiée dans la fonction acmFormatTagEnum.

fdwSupport

Indicateurs de prise en charge du pilote spécifiques à la balise de format. Ces indicateurs sont identiques à la structure ACMDRIVERDETAILS. Ce paramètre peut être une combinaison des valeurs suivantes et indique les opérations que le pilote prend en charge avec la balise de format.

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 où l’une des balises est la balise de format spécifiée. Par exemple, si un pilote prend en charge la compression de WAVE_FORMAT_PCM à WAVE_FORMAT_ADPCM, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Le pilote prend en charge la conversion entre deux formats différents de la balise de format spécifiée. Par exemple, si un pilote prend en charge le rééchantillonnage de WAVE_FORMAT_PCM, 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 la balise de format spécifiée, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Le pilote prend en charge l’entrée matérielle, la sortie ou les deux de la balise de format spécifiée par le biais d’un périphérique audio de forme d’onde. Une application doit utiliser 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 pris en charge.

Valeur de retour

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

Remarques

La fonction acmFormatTagEnum retourne MMSYSERR_NOERROR (zéro) si aucune balise de format n’est énumérée. De plus, 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, acmDriverRemoveet acmDriverPriority.

Note

L’en-tête msacm.h définit ACMFORMATTAGENUMCB comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	msacm.h

Voir aussi

fonctions de compression audio

du Gestionnaire de compression audio

Partager via