acmFilterEnumW, fonction (msacm.h)
La fonction acmFilterEnum énumère les filtres audio de forme d’onde disponibles pour une balise de filtre donnée à partir d’un pilote ACM. Cette fonction continue d’énumérer jusqu’à ce qu’il n’y ait plus de filtres appropriés pour la balise de filtre ou que la fonction de rappel retourne FALSE.
Syntaxe
MMRESULT ACMAPI acmFilterEnumW(
HACMDRIVER had,
LPACMFILTERDETAILSW pafd,
ACMFILTERENUMCBW fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Paramètres
had
Gérez le pilote ACM pour interroger les détails du filtre audio de forme d’onde. Si ce paramètre a la valeur NULL, ACM utilise les détails du premier pilote ACM approprié.
pafd
Pointeur vers la structure ACMFILTERDETAILS qui contient les détails du filtre lorsqu’il est passé à la fonction spécifiée par fnCallback. Lorsque votre application appelle acmFilterEnum, les membres cbStruct, pwfltr et cbwfltr de cette structure doivent être initialisés. Le membre dwFilterTag doit également être initialisé à WAVE_FILTER_UNKNOWN ou à une balise de filtre valide.
fnCallback
Adresse instance procédure de la fonction de rappel définie par l’application.
dwInstance
Valeur 32 bits (DWORD), 64 bits (DWORD_PTR) définie par l’application qui est passée à la fonction de rappel avec les détails du filtre ACM.
fdwEnum
Indicateurs permettant d’énumérer les filtres pour une balise de filtre donnée. Les valeurs suivantes sont définies.
[ACMFILTERDETAILS] La structure (./nf-msacm-acmfilterdetails.md) est valide. L’énumérateur énumère uniquement un filtre conforme à cet attribut. Le membre dwFilterTag de la structure ACMFILTERDETAILS doit être égal au membre dwFilterTag de la structure WAVEFILTER .| Valeur | Signification |
|---|---|
| ACM_FILTERENUMF_DWFILTERTAG |
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 |
|---|---|
|
Les détails du filtre ne peuvent pas être retournés. |
|
Au moins un indicateur n’est pas valide. |
|
Le handle spécifié n’est pas valide. |
|
Au moins un paramètre n’est pas valide. |
Notes
La fonction acmFilterEnum retourne MMSYSERR_NOERROR (zéro) si aucun pilote ACM approprié 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.
Notes
L’en-tête msacm.h définit acmFilterEnum 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. La combinaison 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.
Configuration requise
| 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 |