acmDriverAdd, fonction (msacm.h)

Article
08/24/2023

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 de pilote reçoit les messages du pilote ACM.

Syntaxe

MMRESULT ACMAPI acmDriverAdd(
  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 la 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 du pilote ou handle de fenêtre de notification, en fonction des 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, que ACM_DRIVERADDF_GLOBAL soit spécifié ou non. 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à commencé à utiliser 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 états et aux priorités des pilotes globaux sont apportées. Le message de fenêtre à recevoir est défini par l’application et doit être passé dans dwPriority. Les paramètres wParam et lParam passés avec le message de fenêtre sont réservés pour 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 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_INVALPARAM	Au moins un paramètre n’est pas valide.
MMSYSERR_NOMEM	Le système ne peut pas allouer de ressources.

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

Voir aussi

Fonctions de compression audio

Gestionnaire de compression audio