commande MCI_BREAK

Article
06/13/2023

La commande MCI_BREAK définit une clé d’arrêt pour un appareil MCI. MCI prend en charge cette commande directement au lieu de la transmettre à l’appareil. Toute application MCI peut utiliser cette commande.

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_BREAK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_BREAK_PARMS) lpBreak
);

Paramètres

wDeviceID: Identificateur de l’appareil MCI devant recevoir le message de commande.
dwFlags: MCI_NOTIFY, MCI_WAIT ou, pour les appareils magnétoscopes numériques et magnétoscopes, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.
lpBreak: Pointeur vers une structure MCI_ BREAK_PARMS .

Valeur renvoyée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire.

Notes

Vous devrez peut-être appuyer plusieurs fois sur la touche d’arrêt pour interrompre une opération d’attente. Appuyer sur la touche d’arrêt après l’annulation d’une attente d’appareil peut envoyer l’arrêt à une application. Si une application a une action définie pour le code de clé virtuelle, elle peut répondre par inadvertance à l’arrêt. Par exemple, une application utilisant VK_CANCEL pour une touche d’accélérateur peut répondre à la touche CTRL+ARRÊT par défaut si elle est enfoncée après l’annulation d’une attente.

Les indicateurs supplémentaires suivants s’appliquent à tous les appareils :

MCI_BREAK_HWND: Le membre hwndBreak de la structure identifiée par lpBreak contient un handle de fenêtre qui doit être la fenêtre active afin d’activer la détection d’arrêt pour cet appareil MCI. Il s’agit généralement de la fenêtre main de l’application. En cas d’omission, MCI ne case activée pas le handle de fenêtre de la fenêtre active.
MCI_BREAK_KEY: Le membre nVirtKey de la structure identifiée par lpBreak spécifie le code de clé virtuelle utilisé pour la clé d’arrêt. Par défaut, MCI affecte Ctrl+Break comme touche d’arrêt. Cet indicateur est obligatoire si MCI_BREAK_OFF n’est pas spécifié.
MCI_BREAK_OFF: Désactive toute clé d’arrêt existante pour l’appareil indiqué.

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	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI
Commandes MCI

Partager via