acmFormatChooseA, fonction (msacm.h)
La fonction acmFormatChoose crée une boîte de dialogue définie par ACM qui permet à l’utilisateur de sélectionner un format audio de forme d’onde.
Syntaxe
MMRESULT ACMAPI acmFormatChooseA(
LPACMFORMATCHOOSEA pafmtc
);
Paramètres
pafmtc
Pointeur vers une structure ACMFORMATCHOOSE qui contient des informations utilisées pour initialiser la boîte de dialogue. Lorsque cette fonction est retournée, cette structure contient des informations sur la sélection de format de l’utilisateur.
Le pwfx membre de cette structure doit contenir un pointeur valide vers un emplacement de mémoire qui contiendra la structure d’en-tête de format retournée. De plus, le membre cbwfx doit être rempli 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 de retour 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 le pwfx membre du ACMFORMATCHOOSE structure est trop petite pour contenir le format 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 format valides. |
Remarques
Note
L’en-tête msacm.h définit ACMFORMATCHOOSE 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 |