acmFormatSuggest, fonction (msacm.h)

La fonction acmFormatSuggest interroge le pilote 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 auxquels un format compressé peut être compressé.

Syntaxe

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

Paramètres

had

Gérez vers une instance ouverte d’un pilote pour interroger un format de destination suggéré. Si ce paramètre est 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 le pilote ACM ou 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ées par pwfxDst peuvent nécessiter l’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 tout format disponible pour le pilote spécifié (ou pour tous les pilotes ACM installés).

fdwSuggest

Indicateurs correspondant au 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 échouer.
ACM_FORMATSUGGESTF_WFORMATTAG Le membre wFormatTag de la structure pointée par pwfxDst est valide. Le module ACM interroge les pilotes installés acceptables qui peuvent suggérer un format de destination correspondant à wFormatTag ou échouer.

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