Partager via


acmFilterDetails, fonction (msacm.h)

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 acmFilterDetails(
  HACMDRIVER         had,
  LPACMFILTERDETAILS 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 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 sous forme de chaîne d’une structure de filtre arbitraire. Si une application spécifie un handle de pilote ACM pour had, les détails sur le filtre sont retournés pour ce pilote. Si une application spécifie NULL pour had, l’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é fourni dans le membre dwFilterIndex de la structure ACMFILTERDETAILS . Les détails du filtre sont retournés dans la structure définie par pafd. L’index est compris entre zéro et 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 à initialiser avant d’appeler cette fonction, consultez la structure ACMFILTERDETAILS .

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

Spécifications

   
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