acmFilterTagDetails, fonction (msacm.h)

  • Article

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

Syntaxe

MMRESULT ACMAPI acmFilterTagDetails(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  DWORD                 fdwDetails
);

Paramètres

had

Gérez le pilote ACM pour interroger les détails de la balise de filtre audio de forme d’onde. Si ce paramètre a la valeur NULL, ACM utilise les détails du premier pilote ACM approprié. Une application doit spécifier un identificateur HACMDRIVER ou HACMDRIVERID valide lors de l’utilisation du type de requête ACM_FILTERTAGDETAILSF_INDEX. Les identificateurs de pilote pour les pilotes désactivés ne sont pas autorisés.

paftd

Pointeur vers la structure ACMFILTERTAGDETAILS qui doit recevoir les détails de la balise de filtre.

fdwDetails

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

[ACMFILTERTAGDETAILS] () structure. Les détails de la balise de filtre sont retournés dans la structure pointée par paftd. Si une application spécifie un handle de pilote ACM pour had, les détails sur la balise de 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. [ACMDRIVERDETAILS] Structure (./nf-msacm-acmdriverdetails.md) pour un pilote ACM. Une application doit spécifier un handle de pilote pour avoir lors de la récupération des détails de la balise de filtre avec cet indicateur.
Valeur Signification
ACM_FILTERTAGDETAILSF_FILTERTAG
ACM_FILTERTAGDETAILSF_INDEX
ACM_FILTERTAGDETAILSF_LARGESTSIZE Les détails de la balise de filtre avec la plus grande taille de filtre, en octets, doivent être retournés. Le membre dwFilterTag doit être WAVE_FILTER_UNKNOWN ou la balise de filtre pour laquelle trouver la plus grande taille. Si une application spécifie un handle de pilote ACM pour had, les détails sur la plus grande balise de filtre sont retournés pour ce pilote. Si une application spécifie NULL pour had, l’ACM trouve un pilote acceptable avec la plus grande balise de filtre demandée pour retourner les détails.

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.

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