Fonction de rappel ACMFILTERENUMCB (msacm.h)
La fonction acmFilterEnumCallback spécifie une fonction de rappel utilisée avec la fonction acmFilterEnum . Le nom acmFilterEnumCallback est un espace réservé pour un nom de fonction défini par l’application.
Syntaxe
ACMFILTERENUMCB Acmfilterenumcb;
BOOL Acmfilterenumcb(
HACMDRIVERID hadid,
LPACMFILTERDETAILS pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Paramètres
hadid
Gérez l’identificateur du pilote ACM.
pafd
Pointeur vers une structure ACMFILTERDETAILS qui contient les détails du filtre énuméré pour une balise de filtre.
dwInstance
Valeur définie par l’application spécifiée dans acmFilterEnum.
fdwSupport
Indicateurs de prise en charge des pilotes spécifiques au pilote identifié par la structure ACMDRIVERDETAILS , mais ils sont spécifiques au filtre énuméré. Ce paramètre peut être une combinaison des valeurs suivantes et identifie les opérations que le pilote prend en charge pour 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 du filtre spécifié. Par exemple, si un pilote prend en charge la compression de WAVE_FORMAT_PCM vers WAVE_FORMAT_ADPCM avec le filtre 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 filtre spécifié. Par exemple, si un pilote prend en charge le rééchantillonnage de WAVE_FORMAT_PCM avec le filtre 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). 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 le filtre spécifié 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 acmFilterEnum retourne MMSYSERR_NOERROR (zéro) si aucun filtre ne doit être énuméré. 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 |