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 waveform-audio.
Syntaxe
MMRESULT ACMAPI acmFilterChooseW(
LPACMFILTERCHOOSEW pafltrc
);
Paramètres
pafltrc
Pointeur vers une structure ACMFILTERCHOOSE qui contient des informations utilisées pour initialiser la boîte de dialogue. Lorsque acmFilterChoose retourne, cette structure contient des informations sur la sélection de filtre de l’utilisateur.
Le pwfltr membre de cette structure doit contenir un pointeur valide vers un emplacement mémoire qui contiendra la structure d’en-tête de filtre retournée. Le cbwfltr membre doit être renseigné avec la taille, en octets, de cette mémoire tampon.
Valeur de retour
Retourne MMSYSERR_NOERROR en cas de réussite ou d’erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
| Retourner le code | 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 filtre valides. |
Remarques
Note
L’en-tête msacm.h définit ACMFILTERCHOOSE 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | msacm.h |
| bibliothèque | Msacm32.lib |
| DLL | Msacm32.dll |