acmFilterChoose, 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 acmFilterChoose(
LPACMFILTERCHOOSE 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]() 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. |
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 |
| Bibliothèque | Msacm32.lib |
| DLL | Msacm32.dll |