fonction acmFilterTagEnum (msacm.h)

  • Article

La fonction acmFilterTagEnum énumère les balises de filtre 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 filtre appropriées ou que la fonction de rappel retourne FALSE.

Syntaxe

MMRESULT ACMAPI acmFilterTagEnum(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  ACMFILTERTAGENUMCB    fnCallback,
  DWORD_PTR             dwInstance,
  DWORD                 fdwEnum
);

Paramètres

had

Gérez le pilote ACM pour interroger les détails de la balise de filtre waveform-audio. Si ce paramètre a la valeur NULL, ACM utilise les détails du premier pilote ACM approprié.

paftd

Pointeur vers la structure ACMFILTERTAGDETAILS qui contient les détails de la balise de filtre lorsqu’elle est transmise à la fonction fnCallback . Lorsque votre application appelle acmFilterTagEnum, le membre cbStruct de cette structure doit être initialisé.

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

fdwEnum

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

Valeur retournée

Retourne zéro en cas de réussite ou d’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