acmDriverMessage, fonction (msacm.h)

La fonction acmDriverMessage envoie un message défini par l’utilisateur à une instance de pilote ACM donnée.

Syntaxe

LRESULT ACMAPI acmDriverMessage(
  HACMDRIVER had,
  UINT       uMsg,
  LPARAM     lParam1,
  LPARAM     lParam2
);

Paramètres

had

Gérez l’instance de pilote ACM à laquelle le message sera envoyé.

uMsg

Message indiquant que le pilote ACM doit traiter. Ce message doit se trouver dans la plage de messages ACMDM_USER (au-dessus ou égal à ACMDM_USER et inférieur à ACMDM_RESERVED_LOW). Les exceptions à cette restriction sont les messages ACMDM_DRIVER_ABOUT, DRV_QUERYCONFIGURE et DRV_CONFIGURE .

lParam1

Paramètre de message.

lParam2

Paramètre de message.

Valeur retournée

La valeur de retour est spécifique au message de pilote ACM défini par l’utilisateur spécifié par le paramètre uMsg. Toutefois, les valeurs d’erreur possibles sont les suivantes.

Code de retour Description
MMSYSERR_INVALHANDLE
Le handle spécifié n’est pas valide.
MMSYSERR_INVALPARAM
Le paramètre uMsg n’est pas dans la plage ACMDM_USER.
MMSYSERR_NOTSUPPORTED
Le pilote ACM n’a pas traité le message.

Notes

Pour afficher une boîte de dialogue À propos personnalisée d’un pilote ACM, une application doit envoyer le message ACMDM_DRIVER_ABOUT au pilote. Le paramètre lParam1 doit être le handle de la fenêtre propriétaire de la boîte de dialogue About personnalisée, et lParam2 doit avoir la valeur zéro. Si le pilote ne prend pas en charge une boîte de dialogue About personnalisée, MMSYSERR_NOTSUPPORTED sera retourné et il incombe à l’application d’afficher sa propre boîte de dialogue. Par exemple, l’option Panneau de configuration Sound Mapper affiche une boîte de dialogue About par défaut basée sur la structure ACMDRIVERDETAILS lorsqu’un pilote ACM retourne MMSYSERR_NOTSUPPORTED. Une application peut interroger un pilote pour la prise en charge personnalisée de la boîte de dialogue À propos de la boîte de dialogue sans que la boîte de dialogue s’affiche en définissant lParam1 sur –1L. Si le pilote prend en charge une boîte de dialogue About personnalisée, MMSYSERR_NOERROR est retourné. Sinon, la valeur de retour est MMSYSERR_NOTSUPPORTED.

Les messages définis par l’utilisateur doivent être envoyés uniquement à un pilote ACM qui prend spécifiquement en charge les messages. L’appelant doit vérifier que le pilote ACM est le pilote correct en récupérant les détails du pilote et en vérifiant les membres wMid, wPid et vdwDriver de la structure ACMDRIVERDETAILS .

N’envoyez jamais de messages définis par l’utilisateur à un pilote ACM inconnu.

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

Voir aussi

Fonctions de compression audio

Gestionnaire de compression audio