acmFormatTagDetailsA, fonction (msacm.h)

Article
08/24/2023

La fonction acmFormatTagDetails interroge l’ACM pour obtenir des détails sur une balise de format audio de forme d’onde spécifique.

Syntaxe

MMRESULT ACMAPI acmFormatTagDetailsA(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSA paftd,
  DWORD                  fdwDetails
);

Paramètres

had

Gérez le pilote ACM pour interroger les détails de la balise de format audio de forme d’onde. Si ce paramètre a la valeur NULL, ACM utilise les détails du premier pilote ACM approprié. Une application doit spécifier un handle ou un identificateur de pilote valide lors de l’utilisation du type de requête ACM_FORMATTAGDETAILSF_INDEX. Les identificateurs de pilote pour les pilotes désactivés ne sont pas autorisés.

paftd

Pointeur vers la structure ACMFORMATTAGDETAILS qui doit recevoir les détails de la balise de format.

fdwDetails

Indicateurs pour obtenir les détails. Les valeurs suivantes sont définies.

[ACMFORMATTAGDETAILS] (./nf-msacm-acmformattagdetails.md) structure. Les détails de la balise de format sont retournés dans la structure pointée par paftd. Si une application spécifie un handle de pilote ACM pour had, les détails sur la balise de 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. [ACMDRIVERDETAILS] Structure (./nf-msacm-acmdriverdetails.md) pour un pilote ACM. Une application doit spécifier un handle de pilote pour avoir lors de la récupération des détails de balise de format avec cet indicateur. [ACMFORMATTAGDETAILS] La structure (./nf-msacm-acmformattagdetails.md) doit être WAVE_FORMAT_UNKNOWN ou la balise de format pour laquelle trouver la plus grande taille. Si une application spécifie un handle de pilote ACM pour had, des détails sur la balise de format la plus grande seront retournées pour ce pilote. Si une application spécifie NULL pour had, l’ACM trouve un pilote acceptable avec la balise de format la plus grande demandée pour retourner les détails.

Valeur	Signification
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

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
ACMERR_NOTPOSSIBLE	Les détails demandés ne sont pas disponibles.
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.

Notes

L’en-tête msacm.h définit ACMFORMATTAGDETAILS 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. 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.

Spécifications


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

Partager via