acmDriverMessage, fonction (msacm.h)
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 |
|---|---|
|
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 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 |