Partager via


acmFormatSuggest, fonction (msacm.h)

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