acmFormatTagEnum, fonction (msacm.h)

  • Article

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 acmFormatTagEnum(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  ACMFORMATTAGENUMCB    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.

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