Fonction de rappel ACMFORMATTAGENUMCBW (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
ACMFORMATTAGENUMCBW Acmformattagenumcbw;
BOOL Acmformattagenumcbw(
HACMDRIVERID hadid,
LPACMFORMATTAGDETAILSW 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é.
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 vers 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 d’appareil 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.
Notes
L’en-tête msacm.h définit ACMFORMATTAGENUMCB comme un 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.
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 |