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 les 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 membre pwfx 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. En outre, le membre cbwfx 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 de retour 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 le membre pwfx de la structure ACMFORMATCHOOSE 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
Notes
L’en-tête msacm.h définit ACMFORMATCHOOSE 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
| 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 |