Fonction de rappel ACMDRIVERENUMCB (msacm.h)
La fonction acmDriverEnumCallback spécifie une fonction de rappel utilisée avec la fonction acmDriverEnum . Le nom acmDriverEnumCallback est un espace réservé pour un nom de fonction défini par l’application.
Syntaxe
ACMDRIVERENUMCB Acmdriverenumcb;
BOOL Acmdriverenumcb(
HACMDRIVERID hadid,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Paramètres
hadid
Gérez vers un identificateur de pilote ACM.
dwInstance
Valeur définie par l’application spécifiée dans acmDriverEnum.
fdwSupport
Indicateurs de prise en charge des pilotes spécifiques au pilote spécifié par la structure ACMDRIVERDETAILS . Ce paramètre peut être une combinaison des valeurs suivantes.
| Valeur | Signification |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | Le pilote prend en charge les conversions asynchrones. |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | Le pilote prend en charge la conversion entre deux balises de format différentes. 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 même balise de format. Par exemple, si un pilote prend en charge le rééchantillonnage de WAVE_FORMAT_PCM, cet indicateur est défini. |
| ACMDRIVERDETAILS_SUPPORTF_DISABLED | Le pilote a été désactivé. Une application doit spécifier l’indicateur ACM_DRIVERENUMF_DISABLED avec acmDriverEnum pour inclure les pilotes désactivés dans l’énumération. |
| 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. |
Valeur retournée
La fonction de rappel doit retourner TRUE pour continuer l’énumération ou FALSE pour arrêter l’énumération.
Remarques
La fonction acmDriverEnum retourne MMSYSERR_NOERROR (zéro) si aucun pilote ACM n’est installé. 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |