Fonction de rappel ACMFORMATENUMCBW (msacm.h)
La fonction acmFormatEnumCallback spécifie une fonction de rappel utilisée avec la fonction acmFormatEnum. Le nom acmFormatEnumCallback est un espace réservé pour le nom de la fonction définie par l’application.
Syntaxe
ACMFORMATENUMCBW Acmformatenumcbw;
BOOL Acmformatenumcbw(
HACMDRIVERID hadid,
LPACMFORMATDETAILSW pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Paramètres
hadid
Gérer l’identificateur du pilote ACM.
pafd
Pointeur vers une structure ACMFORMATDETAILS qui contient les détails de format énumérés pour une balise de format.
dwInstance
Valeur définie par l’application spécifiée dans la fonction acmFormatEnum.
fdwSupport
Indicateurs de prise en charge des pilotes spécifiques au pilote identifié par ACMDRIVERDETAILS structure, mais ils sont spécifiques au format énuméré. Ce paramètre peut être une combinaison des valeurs suivantes et indique les opérations que le pilote prend en charge pour 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 pour le format spécifié. Par exemple, si un pilote prend en charge la compression de WAVE_FORMAT_PCM à WAVE_FORMAT_ADPCM avec le format 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 lors de l’utilisation du format spécifié. Par exemple, si un pilote prend en charge le rééchantillonnage de WAVE_FORMAT_PCM au format 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) avec le format spécifié. 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 balises de format spécifiées via un périphérique audio de forme d’onde. Une application doit utiliser la fonction acmMetrics avec les index de métriques 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 acmFormatEnum retourne MMSYSERR_NOERROR (zéro) si aucun format n’est énuméré. 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 ACMFORMATENUMCB 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 |