acmFilterDetails, fonction (msacm.h)
La fonction acmFilterDetails interroge l’ACM pour obtenir des détails sur un filtre avec une balise de filtre audio de forme d’onde spécifique.
Syntaxe
MMRESULT ACMAPI acmFilterDetails(
HACMDRIVER had,
LPACMFILTERDETAILS pafd,
DWORD fdwDetails
);
Paramètres
had
Gérez le pilote ACM pour interroger les détails du filtre audio de forme d’onde pour une balise de filtre. Si ce paramètre a la valeur NULL, ACM utilise les détails du premier pilote ACM approprié.
pafd
Pointeur vers la structure ACMFILTERDETAILS qui doit recevoir les détails du filtre pour la balise de filtre donnée.
fdwDetails
Indicateurs pour obtenir les détails. Les valeurs suivantes sont définies.
[ACMFILTERDETAILS] () la structure a été donnée et les détails restants doivent être retournés. Le membre dwFilterTag de la structure ACMFILTERDETAILS doit être initialisé à la même balise de filtre que pwfltr spécifie. Ce type de requête peut être utilisé pour obtenir une description sous forme de chaîne d’une structure de filtre arbitraire. Si une application spécifie un handle de pilote ACM pour had, les détails sur le filtre sont retournés pour ce pilote. Si une application spécifie NULL pour had, l’ACM trouve le premier pilote acceptable pour retourner les détails.| Valeur | Signification |
|---|---|
| ACM_FILTERDETAILSF_FILTER | |
| ACM_FILTERDETAILSF_INDEX | Un index de filtre pour la balise de filtre a été fourni dans le membre dwFilterIndex de la structure ACMFILTERDETAILS . Les détails du filtre sont retournés dans la structure définie par pafd. L’index est compris entre zéro et un de moins que le membre cStandardFilters retourné dans la structure ACMFILTERTAGDETAILS pour une balise de filtre. Une application doit spécifier un handle de pilote pour avoir lors de la récupération des détails du filtre avec cet indicateur. Pour plus d’informations sur les membres à initialiser avant d’appeler cette fonction, consultez la structure ACMFILTERDETAILS . |
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 |
|---|---|
|
Les détails demandés ne sont pas disponibles. |
|
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. |
Spécifications
| 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 |