MM_MCINOTIFY message
Le message MM_MCINOTIFY avertit une application qu’un appareil MCI a terminé une opération. Les appareils MCI envoient ce message uniquement lorsque l’indicateur MCI_NOTIFY est utilisé.
MM_MCINOTIFY
wParam = (WPARAM) wFlags
lParam = (LONG) lDevID
Paramètres
-
wFlags
-
Raison de la notification. Les valeurs suivantes sont définies :
Condition requise Valeur MCI_NOTIFY_ABORTED L’appareil a reçu une commande qui empêchait les conditions actuelles de lancement de la fonction de rappel d’être remplies. Si une nouvelle commande interrompt la commande actuelle et qu’elle demande également une notification, l’appareil envoie ce message uniquement et non MCI_NOTIFY_SUPERSEDED MCI_NOTIFY_FAILURE Une erreur d’appareil s’est produite pendant que l’appareil exécutait la commande. MCI_NOTIFY_SUCCESSFUL Les conditions à l’origine de la fonction de rappel ont été remplies. MCI_NOTIFY_SUPERSEDED L’appareil a reçu une autre commande avec l’indicateur « notifier » défini et les conditions actuelles de lancement de la fonction de rappel ont été remplacées. -
lDevID
-
Identificateur de l’appareil qui lance la fonction de rappel.
Valeur renvoyée
Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.
Notes
Pour plus d’informations sur l’indicateur MCI_NOTIFY, consultez Indicateur de notification.
Un appareil retourne l’indicateur MCI_NOTIFY_SUCCESSFUL avec MM_MCINOTIFY lorsque l’action d’une commande se termine. Par exemple, un périphérique audio CD utilise cet indicateur pour la notification de la commande de lecture ( MCI_PLAY) lorsque l’appareil a terminé la lecture. La commande de lecture réussit uniquement lorsqu’elle atteint la position de fin spécifiée ou atteint la fin du média. De même, les commandes seek ( MCI_SEEK) et record ( MCI_RECORD) ne retournent pas MCI_NOTIFY_SUCCESSFUL tant qu’elles n’atteignent pas la position de fin spécifiée ou atteignent la fin du support.
Un appareil retourne l’indicateur MCI_NOTIFY_ABORTED avec MM_MCINOTIFY uniquement lorsqu’il reçoit une commande qui l’empêche de répondre aux conditions de notification. Par exemple, la commande play n’abandonne pas la notification pour une commande de lecture précédente, à condition que la nouvelle commande ne modifie pas le sens de lecture ni la position de fin. Les commandes de recherche et d’enregistrement se comportent de la même façon. MCI n’envoie pas non plus de MCI_NOTIFY_ABORTED lorsque la lecture ou l’enregistrement est suspendu avec la commande pause ( MCI_PAUSE). L’envoi de la commande CV ( MCI_RESUME) leur permet de continuer à remplir les conditions de rappel.
Lorsque votre application demande une notification pour une commande, case activée le retour d’erreur des fonctions mciSendString ou mciSendCommand. Si ces fonctions rencontrent une erreur et retournent une valeur différente de zéro, MCI ne définit pas la notification pour la commande.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|