acmFilterChooseW, fonction (msacm.h)
La fonction acmFilterChoose crée une boîte de dialogue définie par ACM qui permet à l’utilisateur de sélectionner un filtre audio de forme d’onde.
Syntaxe
MMRESULT ACMAPI acmFilterChooseW(
LPACMFILTERCHOOSEW pafltrc
);
Paramètres
pafltrc
Pointeur vers une structure ACMFILTERCHOOSE qui contient les informations utilisées pour initialiser la boîte de dialogue. Quand acmFilterChoose est retourné, cette structure contient des informations sur la sélection de filtre de l’utilisateur.
Le membre pwfltr de cette structure doit contenir un pointeur valide vers un emplacement de mémoire qui contiendra la structure d’en-tête de filtre retournée. Le membre cbwfltr doit être rempli avec la taille, en octets, de cette mémoire tampon.
Valeur retournée
Retourne MMSYSERR_NOERROR en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
L’utilisateur a choisi le bouton Annuler ou la commande Fermer dans le menu Système pour fermer la boîte de dialogue. |
|
La mémoire tampon identifiée par la structure [ACMFILTERCHOOSE](./nf-msacm-acmfilterchoose.md) est trop petite pour contenir le filtre sélectionné. |
|
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. |
|
Un pilote approprié n’est pas disponible pour fournir des sélections de filtres valides. |
Notes
Notes
L’en-tête msacm.h définit ACMFILTERCHOOSE en tant qu’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 |