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 |
|---|---|
|
Au moins un indicateur n’est pas valide. |
|
Le handle spécifié n’est pas valide. |
|
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 |