Fonction de rappel ACMFORMATTAGENUMCB (msacm.h)
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
ACMFORMATTAGENUMCB Acmformattagenumcb;
BOOL Acmformattagenumcb(
HACMDRIVERID hadid,
LPACMFORMATTAGDETAILS paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Paramètres
hadid
Gérez 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 des pilotes 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 en 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 via un périphérique audio de forme d’onde. Une application doit utiliser acmMetrics avec les index ACM_METRIC_HARDWARE_WAVE_INPUT et ACM_METRIC_HARDWARE_WAVE_OUTPUT métriques 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 acmFormatTagEnum retourne MMSYSERR_NOERROR (zéro) si aucune balise de format 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 |