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 |
|---|---|
|
Le handle spécifié n’est pas valide. |
|
Le paramètre uMsg n’est pas dans la plage ACMDM_USER. |
|
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 |