acmFilterChoose, fonction (msacm.h)

  • Article

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
ACMERR_CANCELED
 L’utilisateur a choisi le bouton Annuler ou la commande Fermer dans le menu Système pour fermer la boîte de dialogue.
ACMERR_NOTPOSSIBLE
 La mémoire tampon identifiée par la structure [ACMFILTERCHOOSE]() est trop petite pour contenir le filtre sélectionné.
MMSYSERR_INVALFLAG
 Au moins un indicateur n’est pas valide.
MMSYSERR_INVALHANDLE
 Le handle spécifié n’est pas valide.
MMSYSERR_INVALPARAM
 Au moins un paramètre n’est pas valide.
MMSYSERR_NODRIVER
 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

Voir aussi

Fonctions de compression audio

Gestionnaire de compression audio