acmFormatDetailsA, fonction (msacm.h)
La fonction acmFormatDetails interroge l’ACM pour obtenir les détails de format d’une balise de format audio de forme d’onde spécifique.
Syntaxe
MMRESULT ACMAPI acmFormatDetailsA(
HACMDRIVER had,
LPACMFORMATDETAILSA pafd,
DWORD fdwDetails
);
Paramètres
had
Gérez le pilote ACM pour interroger les détails du format audio de forme d’onde pour une balise de format. Si ce paramètre a la valeur NULL, ACM utilise les détails du premier pilote ACM approprié.
pafd
Pointeur vers une structure ACMFORMATDETAILS pour contenir les détails de format de la balise de format donnée.
fdwDetails
Indicateurs permettant d’obtenir les détails de la balise de format audio de forme d’onde. Les valeurs suivantes sont définies.
[ACMFORMATDETAILS] La structure (./nf-msacm-acmformatdetails.md) a été donnée et les détails restants doivent être retournés. Le membre dwFormatTag de la structure ACMFORMATDETAILS doit être initialisé à la même balise de format que pwfx spécifie. Ce type de requête peut être utilisé pour obtenir une description sous forme de chaîne d’une structure de format arbitraire. Si une application spécifie un handle de pilote ACM pour had, des détails sur le format sont retournés pour ce pilote. Si une application spécifie NULL pour had, l’ACM trouve le premier pilote acceptable pour retourner les détails.| Valeur | Signification |
|---|---|
| ACM_FORMATDETAILSF_FORMAT | |
| ACM_FORMATDETAILSF_INDEX | Un index de format pour la balise de format a été fourni dans le membre dwFormatIndex de la structure ACMFORMATDETAILS . Les détails du format sont retournés dans la structure définie par pafd. L’index est compris entre zéro et un de moins que le membre cStandardFormats retourné dans la structure ACMFORMATTAGDETAILS pour une balise de format. Une application doit spécifier un handle de pilote pour avoir lors de la récupération des détails de format avec cet indicateur. Pour plus d’informations sur les membres à initialiser avant d’appeler cette fonction, consultez la structure ACMFORMATDETAILS . |
Valeur retournée
Retourne zéro en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Les détails demandés ne sont pas disponibles. |
|
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. |
Notes
Notes
L’en-tête msacm.h définit ACMFORMATDETAILS 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
| 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 |