acmDriverMessage, fonction (msacm.h)

  • Article

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

Syntaxe

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

Paramètres

had

Gérez le pilote ACM instance auquel le message sera envoyé.

uMsg

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

lParam1

Paramètre message.

lParam2

Paramètre 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 traiter le message.

Notes

Pour afficher une boîte de dialogue À propos de à partir 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 pour la boîte de dialogue À propos de , et lParam2 doit être défini sur zéro. Si le pilote ne prend pas en charge une boîte de dialogue À propos de , MMSYSERR_NOTSUPPORTED sera retourné et il incombe à l’application d’afficher sa propre boîte de dialogue. Par exemple, l’option Panneau de configuration Mappeur sonore affiche une boîte de dialogue Par défaut À propos de 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 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 À propos de, MMSYSERR_NOERROR sont retournées. 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.

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