acmFormatTagEnum, fonction (msacm.h)
La fonction acmFormatTagEnum énumère les balises de format audio waveform disponibles à partir d’un pilote ACM. Cette fonction continue d’énumérer jusqu’à ce qu’il n’y ait plus d’étiquettes de format appropriées ou que la fonction de rappel retourne FALSE.
Syntaxe
MMRESULT ACMAPI acmFormatTagEnum(
HACMDRIVER had,
LPACMFORMATTAGDETAILS paftd,
ACMFORMATTAGENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Paramètres
had
Gérez le pilote ACM pour rechercher les détails de la balise de format waveform-audio. Si ce paramètre a la valeur NULL, ACM utilise les détails du premier pilote ACM approprié.
paftd
Pointeur vers la structure ACMFORMATTAGDETAILS qui doit recevoir les détails de balise de format transmis à la fonction spécifiée dans fnCallback. Cette structure doit avoir le membre cbStruct de la structure ACMFORMATTAGDETAILS initialisée.
fnCallback
Adresse de l’instance de procédure de la fonction de rappel définie par l’application.
dwInstance
Valeur définie par l’application 64 bits (DWORD_PTR) ou 32 bits (DWORD) transmise à la fonction de rappel, ainsi que les détails de la balise de format ACM.
fdwEnum
Réservés au; doit être égal à zéro.
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. |
Remarques
Cette fonction retourne MMSYSERR_NOERROR (zéro) si aucun pilote ACM approprié n’est installé. En outre, la fonction de rappel n’est pas appelée.
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 |