acmFilterEnumW, fonction (msacm.h)

Article
11/20/2024

La fonction acmFilterEnum énumère les filtres waveform-audio disponibles pour une balise de filtre donnée à partir d’un pilote ACM. Cette fonction continue d’énumérer jusqu’à ce qu’il n’y ait plus de filtres appropriés pour la balise de filtre ou que la fonction de rappel retourne FALSE.

Syntaxe

MMRESULT ACMAPI acmFilterEnumW(
  HACMDRIVER          had,
  LPACMFILTERDETAILSW pafd,
  ACMFILTERENUMCBW    fnCallback,
  DWORD_PTR           dwInstance,
  DWORD               fdwEnum
);

Paramètres

had

Gérez le pilote ACM pour rechercher les détails du filtre audio waveform. Si ce paramètre est NULL, le gestionnaire de configuration ACM utilise les détails du premier pilote ACM approprié.

pafd

Pointeur vers la structure ACMFILTERDETAILS qui contient les détails du filtre lorsqu’il est passé à la fonction spécifiée par fnCallback. Lorsque votre application appelle acmFilterEnum, lescbStruct , pwfltret cbwfltr membres de cette structure doivent être initialisés. Le membre dwFilterTag doit également être initialisé pour WAVE_FILTER_UNKNOWN ou une balise de filtre valide.

fnCallback

Adresse de l’instance de procédure de la fonction de rappel définie par l’application.

dwInstance

Valeur définie par l’application 32 bits (DWORD), 64 bits (DWORD_PTR) définie par l’application qui est passée à la fonction de rappel, ainsi que les détails du filtre ACM.

fdwEnum

Indicateurs pour énumérer les filtres d’une balise de filtre donnée. Les valeurs suivantes sont définies.

[ACMFILTERDETAILS]La structure (./nf-msacm-acmfilterdetails.md) est valide. L’énumérateur énumère uniquement un filtre conforme à cet attribut. Le membre dwFilterTag de la structure ACMFILTERDETAILS doit être égal au membre dwFilterTag de la structure WAVEFILTER.

Valeur	Signification
ACM_FILTERENUMF_DWFILTERTAG

Valeur de retour

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Retourner le code	Description
ACMERR_NOTPOSSIBLE	Les détails du filtre ne peuvent pas être retournés.
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

La fonction acmFilterEnum retourne MMSYSERR_NOERROR (zéro) si aucun pilote ACM approprié n’est installé. De plus, la fonction de rappel n’est pas appelée.

Les fonctions suivantes ne doivent pas être appelées à partir de la fonction de rappel : acmDriverAdd, acmDriverRemoveet acmDriverPriority.

Note

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	msacm.h
bibliothèque	Msacm32.lib
DLL	Msacm32.dll

Voir aussi

fonctions de compression audio

du Gestionnaire de compression audio

Partager via