acmFormatSuggest, fonction (msacm.h)

Article
08/24/2023

La fonction acmFormatSuggest interroge l’ACM ou un pilote ACM spécifié pour suggérer un format de destination pour le format source fourni. Par exemple, une application peut utiliser cette fonction pour déterminer un ou plusieurs formats PCM valides dans lesquels un format compressé peut être décompressé.

Syntaxe

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

Paramètres

had

Gérez vers un instance ouvert d’un pilote pour interroger un format de destination suggéré. Si ce paramètre a la valeur NULL, ACM tente de trouver le meilleur pilote pour suggérer un format de destination.

pwfxSrc

Pointeur vers une structure WAVEFORMATEX qui identifie le format source pour lequel un format de destination sera suggéré par l’ACM ou le pilote spécifié.

pwfxDst

Pointeur vers une structure WAVEFORMATEX qui recevra le format de destination suggéré pour le format pwfxSrc . Selon le paramètre fdwSuggest , certains membres de la structure pointée par pwfxDst peuvent nécessiter une initialisation.

cbwfxDst

Taille, en octets, disponible pour le format de destination. Les fonctions acmMetrics et acmFormatTagDetails peuvent être utilisées pour déterminer la taille maximale requise pour n’importe quel format disponible pour le pilote spécifié (ou pour tous les pilotes ACM installés).

fdwSuggest

Indicateurs pour la correspondance avec le format de destination souhaité. Les valeurs suivantes sont définies.

Valeur	Signification
ACM_FORMATSUGGESTF_NCHANNELS	Le membre nChannels de la structure pointée par pwfxDst est valide. L’ACM interroge les pilotes installés acceptables qui peuvent suggérer un format de destination correspondant à nChannels ou échouer.
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	Le membre nSamplesPerSec de la structure pointée par pwfxDst est valide. L’ACM interroge les pilotes installés acceptables qui peuvent suggérer un format de destination correspondant à nSamplesPerSec ou échouer.
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	Le membre wBitsPerSample de la structure pointée par pwfxDst est valide. L’ACM interroge les pilotes installés acceptables qui peuvent suggérer un format de destination correspondant à wBitsPerSample ou fail.
ACM_FORMATSUGGESTF_WFORMATTAG	Le membre wFormatTag de la structure pointée par pwfxDst est valide. L’ACM interroge les pilotes installés acceptables qui peuvent suggérer un format de destination correspondant à wFormatTag ou à un échec.

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


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