acmFormatTagEnumW, fonction (msacm.h)

Article
03/04/2024

La fonction acmFormatTagEnum énumère les balises de format audio de forme d’onde disponibles à partir d’un pilote ACM. Cette fonction continue d’énumérer jusqu’à ce qu’il n’y ait plus de balises de format appropriées ou que la fonction de rappel retourne FALSE.

Syntaxe

MMRESULT ACMAPI acmFormatTagEnumW(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSW paftd,
  ACMFORMATTAGENUMCBW    fnCallback,
  DWORD_PTR              dwInstance,
  DWORD                  fdwEnum
);

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é.

paftd

Pointeur vers la structure ACMFORMATTAGDETAILS qui doit recevoir les détails de balise de format passés à la fonction spécifiée dans fnCallback. Le membre cbStruct de la structure ACMFORMATTAGDETAILS doit être initialisé pour cette structure.

fnCallback

Procédure instance adresse de la fonction de rappel définie par l’application.

dwInstance

Valeur définie par l’application 64 bits (DWORD_PTR) ou 32 bits (DWORD) qui est passée à la fonction de rappel avec les détails de la balise de format ACM.

fdwEnum

Réservés au; doit être égal à zéro.

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
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.

Remarques

Cette fonction retourne MMSYSERR_NOERROR (zéro) si aucun pilote ACM approprié n’est installé. En outre, la fonction de rappel n’est pas appelée.

Notes

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

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

Partager via