acmDriverEnum, fonction (msacm.h)
La fonction acmDriverEnum énumère les pilotes ACM disponibles, en continuant jusqu’à ce qu’il n’y ait plus de pilotes ou que la fonction de rappel retourne FALSE.
Syntaxe
MMRESULT ACMAPI acmDriverEnum(
ACMDRIVERENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Paramètres
fnCallback
Procédure instance adresse de la fonction de rappel définie par l’application.
dwInstance
Valeur définie par l’application 64 bits (DWORD_PTR) ou 32 bits (DWORD) qui est passée à la fonction de rappel avec les informations du pilote ACM.
fdwEnum
Indicateurs pour l’énumération des pilotes ACM. Les valeurs suivantes sont définies.
Valeur | Signification |
---|---|
ACM_DRIVERENUMF_DISABLED | Les pilotes ACM désactivés doivent être inclus dans l’énumération. Les pilotes peuvent être désactivés par l’utilisateur via le Panneau de configuration ou par une application à l’aide de la fonction acmDriverPriority. Si un pilote est désactivé, l’indicateur ACMDRIVERDETAILS_SUPPORTF_DISABLED est défini sur le paramètre fdwSupport de la fonction de rappel. |
ACM_DRIVERENUMF_NOLOCAL | Seuls les pilotes globaux doivent être inclus dans l’énumération. |
Valeur retournée
Retourne zéro en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
Code de retour | Description |
---|---|
|
Au moins un indicateur n’est pas valide. |
|
Au moins un paramètre n’est pas valide. |
Notes
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.
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 |
Bibliothèque | Msacm32.lib |
DLL | Msacm32.dll |