fonction acmFormatDetails (msacm.h)

Article
03/04/2024

La fonction acmFormatDetails interroge l’ACM pour obtenir les détails de format d’une balise de format audio de forme d’onde spécifique.

Syntaxe

MMRESULT ACMAPI acmFormatDetails(
  HACMDRIVER         had,
  LPACMFORMATDETAILS pafd,
  DWORD              fdwDetails
);

Paramètres

had

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

pafd

Pointeur vers une structure ACMFORMATDETAILS pour contenir les détails du format de la balise de format donnée.

fdwDetails

Indicateurs permettant d’obtenir les détails de l’étiquette de format audio waveform. Les valeurs suivantes sont définies.

[ACMFORMATDETAILS] () la structure a été donnée et les détails restants doivent être retournés. Le membre dwFormatTag de la structure ACMFORMATDETAILS doit être initialisé avec la même balise de format que pwfx spécifie. Ce type de requête peut être utilisé pour obtenir une description de chaîne d’une structure de format arbitraire. Si une application spécifie un handle de pilote ACM pour had, les détails sur le format 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_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX	Un index de format pour la balise de format a été donné dans le membre dwFormatIndex de la structure ACMFORMATDETAILS . Les détails du format seront retournés dans la structure définie par pafd. L’index varie de zéro à un de moins que le membre cStandardFormats retourné dans la structure ACMFORMATTAGDETAILS pour une balise de format. Une application doit spécifier un handle de pilote pour avoir lors de la récupération des détails de format avec cet indicateur. Pour plus d’informations sur les membres à initialiser avant d’appeler cette fonction, consultez la structure ACMFORMATDETAILS .

Valeur

Signification

ACM_FORMATDETAILSF_FORMAT

ACM_FORMATDETAILSF_INDEX

Un index de format pour la balise de format a été donné dans le membre dwFormatIndex de la structure ACMFORMATDETAILS . Les détails du format seront retournés dans la structure définie par pafd. L’index varie de zéro à un de moins que le membre cStandardFormats retourné dans la structure ACMFORMATTAGDETAILS pour une balise de format. Une application doit spécifier un handle de pilote pour avoir lors de la récupération des détails de format avec cet indicateur. Pour plus d’informations sur les membres à initialiser avant d’appeler cette fonction, consultez la structure ACMFORMATDETAILS .

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.

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