acmDriverAddA, fonction (msacm.h)

Article
11/20/2024

La fonction acmDriverAdd ajoute un pilote à la liste des pilotes ACM disponibles. Le type et l’emplacement du pilote dépendent des indicateurs utilisés pour ajouter des pilotes ACM. Une fois qu’un pilote a été ajouté, la fonction d’entrée du pilote reçoit les messages du pilote ACM.

Syntaxe

MMRESULT ACMAPI acmDriverAddA(
  LPHACMDRIVERID phadid,
  HINSTANCE      hinstModule,
  LPARAM         lParam,
  DWORD          dwPriority,
  DWORD          fdwAdd
);

Paramètres

phadid

Pointeur vers la mémoire tampon qui reçoit un handle identifiant le pilote installé. Ce handle est utilisé pour identifier le pilote dans les appels à d’autres fonctions ACM.

hinstModule

Gérez l’instance du module dont l’exécutable ou la bibliothèque de liens dynamiques (DLL) contient la fonction d’entrée de pilote.

lParam

Adresse de la fonction de pilote ou handle de fenêtre de notification, selon les indicateurs fdwAdd.

dwPriority

Message de fenêtre à envoyer pour les diffusions de notification. Ce paramètre est utilisé uniquement avec l’indicateur ACM_DRIVERADDF_NOTIFYHWND. Tous les autres indicateurs nécessitent que ce membre soit défini sur zéro.

fdwAdd

Indicateurs pour l’ajout de pilotes ACM. Les valeurs suivantes sont définies.

Valeur	Signification
ACM_DRIVERADDF_FUNCTION	Le paramètre lParam est une adresse de fonction de pilote conforme au prototype acmDriverProc. La fonction peut résider dans un fichier exécutable ou DLL.
ACM_DRIVERADDF_GLOBAL	Fourni pour la compatibilité avec les applications 16 bits. Pour l’API Win32, les pilotes ACM ajoutés par la fonction acmDriverAdd peuvent être utilisés uniquement par l’application qui a ajouté le pilote. Cela est vrai si ACM_DRIVERADDF_GLOBAL est spécifié. Pour plus d’informations, consultez Ajout de pilotes dans une application.
ACM_DRIVERADDF_LOCAL	L’ACM donne automatiquement une priorité plus élevée à un pilote local qu’un pilote global lors de la recherche d’un pilote pour satisfaire un appel de fonction. Pour plus d’informations, consultez Ajout de pilotes dans une application.
ACM_DRIVERADDF_NAME	Le paramètre lParam est un nom de valeur de Registre dans HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Drivers32. La valeur identifie une DLL qui implémente un codec ACM. Les applications peuvent utiliser cet indicateur si de nouvelles entrées de Registre sont créées une fois que l’application a déjà démarré à l’aide de l’ACM.
ACM_DRIVERADDF_NOTIFYHWND	Le paramètre lParam est un handle d’une fenêtre de notification qui reçoit des messages lorsque des modifications apportées aux priorités et états globaux des pilotes sont apportées. Le message de fenêtre à recevoir est défini par l’application et doit être transmis dans dwPriority . Les paramètres wParam et lParam passés avec le message de fenêtre sont réservés à une utilisation ultérieure et doivent être ignorés. ACM_DRIVERADDF_GLOBAL ne peut pas être spécifié conjointement avec cet indicateur. Pour plus d’informations sur les priorités des pilotes, consultez la description de la fonction acmDriverPriority.

Valeur de retour

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Retourner le code	Description
MMSYSERR_INVALFLAG	Au moins un indicateur n’est pas valide.
MMSYSERR_INVALPARAM	Au moins un paramètre n’est pas valide.
MMSYSERR_NOMEM	Le système ne peut pas allouer de ressources.

Remarques

Note

L’en-tête msacm.h définit acmDriverAdd comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	msacm.h
bibliothèque	Msacm32.lib
DLL	Msacm32.dll

Voir aussi

fonctions de compression audio

du Gestionnaire de compression audio

Partager via