fonction acmFilterDetailsA (msacm.h)

Article
02/29/2024

La fonction acmFilterDetails interroge l’ACM pour obtenir des détails sur un filtre avec une balise de filtre audio de forme d’onde spécifique.

Syntaxe

MMRESULT ACMAPI acmFilterDetailsA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA pafd,
  DWORD               fdwDetails
);

Paramètres

had

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

pafd

Pointeur vers la structure ACMFILTERDETAILS qui doit recevoir les détails du filtre pour la balise de filtre donnée.

fdwDetails

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

[ACMFILTERDETAILS] La structure (./nf-msacm-acmfilterdetails.md) a été donnée et les détails restants doivent être retournés. Le membre dwFilterTag de la structure ACMFILTERDETAILS doit être initialisé à la même balise de filtre que pwfltr spécifie. Ce type de requête peut être utilisé pour obtenir une description de chaîne d’une structure de filtre arbitraire. Si une application spécifie un handle de pilote ACM pour had, les détails du filtre seront retournés pour ce pilote. Si une application spécifie NULL pour had, ACM trouve le premier pilote acceptable pour retourner les détails.

Valeur	Signification
ACM_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX	Un index de filtre pour la balise de filtre a été donné dans le membre dwFilterIndex de la structure ACMFILTERDETAILS . Les détails du filtre seront retournés dans la structure définie par pafd. L’index varie de zéro à un de moins que le membre cStandardFilters retourné dans la structure ACMFILTERTAGDETAILS pour une balise de filtre. Une application doit spécifier un handle de pilote pour avoir lors de la récupération des détails du filtre avec cet indicateur. Pour plus d’informations sur les membres qui doivent être initialisés avant d’appeler cette fonction, consultez la structure ACMFILTERDETAILS .

Valeur

Signification

ACM_FILTERDETAILSF_FILTER

ACM_FILTERDETAILSF_INDEX

Un index de filtre pour la balise de filtre a été donné dans le membre dwFilterIndex de la structure ACMFILTERDETAILS . Les détails du filtre seront retournés dans la structure définie par pafd. L’index varie de zéro à un de moins que le membre cStandardFilters retourné dans la structure ACMFILTERTAGDETAILS pour une balise de filtre. Une application doit spécifier un handle de pilote pour avoir lors de la récupération des détails du filtre avec cet indicateur. Pour plus d’informations sur les membres qui doivent être initialisés avant d’appeler cette fonction, consultez la structure ACMFILTERDETAILS .

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

Remarques

Notes

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

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